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About This Guide 


The Novell Vibe 3.4 Installation Guide covers the installation and configuration of Novell Vibe. The 
guide is divided into the following sections: 


+ Part I, “Product Overview,” on page 13 

* Part Il, “Basic Installation,” on page 33 

* Part Ill, “Advanced Installation and Reconfiguration,” on page 93 
* Part IV, “Multi-Server Configurations and Clustering,” on page 127 
* Part V, “Update,” on page 167 

* Part VI, “Migrate,” on page 207 

+ Part VII, “Appendixes,” on page 219 


Audience 


This guide is intended for Novell Vibe administrators. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation. 


Documentation Updates 


For the most recent version of this manual, visit the Novell Vibe 3.4 Documentation Web site (http:// 
www.novell.com/documentation/vibe34). 


Additional Documentation 


You can find more information in the Novell Vibe documentation, which is accessible from the Novell 
Vibe 3.4 Documentation Web site (http://www.novell.com/documentation/vibe34). 


To access the Novell Vibe User Guide from within Vibe, click the Settings icon, then click Help. 
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| Product Overview 


* Chapter 1, “What Is Novell Vibe?,” on page 15 
* Chapter 2, “Vibe System Requirements,” on page 19 
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1.1 


1.1.1 


1.1.2 


What Is Novell Vibe? 


Novell Vibe is an enterprise collaboration tool designed to increase individual productivity, team 
effectiveness, and organizational success by providing the right set of tools to the right people. 
* Section 1.1, “Vibe Capabilities,” on page 15 
* Section 1.2, “Vibe Components,” on page 16 


¢ Section 1.3, “Vibe Configurations,” on page 17 


Vibe Capabilities 
Novell Vibe users fall into three basic groups: 


* Section 1.1.1, “Content Consumers,” on page 15 
* Section 1.1.2, “Content Providers,” on page 15 


* Section 1.1.3, “Administrators,” on page 16 


Content Consumers 


Content consumers use Novell Vibe to work with important information that pertains to them. Content 
consumers: 


¢ Maintain their personal workspaces, including setting up a personal Blog, Calendar, Files, 
Guestbook, Photo Album, and Tasks folder 


¢ Participate in team workspaces set up for content providers, in order to better collaborate with 
colleagues and facilitate their work assignments 


* Search the Vibe site for people, places, and other information that pertains to their personal work 
assignments 


* Identify subject-matter experts to assist them in their personal work assignments 
The typical tasks performed by content consumers are covered in the Novell Vibe 3.4 User Guide. 


In many cases, content consumers quickly become content providers. 


Content Providers 


Content providers use Novell Vibe to create and manage teams, customize the Vibe environment, 
and import data into the Vibe site for use by other Vibe users. Content providers: 

* Create and manage team workspaces and folders 

* Control user access to their team workspaces 


¢ Establish unique branding for workspaces and folders to clearly differentiate them from other 
places on the Vibe site 


* Create landing pages for workspaces that consolidate the most necessary workspace 
information into a single page 
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1.1.3 


1.2 


1.2.1 


1.2.2 


* Customize data entry forms for gathering information from users 
* Create workflows to automate otherwise time-consuming manual processes 


The typical tasks performed by content providers are covered in the Novell Vibe 3.4 User Guide. 


Administrators 


A Novell Vibe administrator is responsible for installing the Vibe software and setting up the Vibe site. 
This Novell Vibe 3.4 Installation Guide provides instructions for Vibe software installation. After 
installation, the Vibe site administrator can: 

* Set up user access to the Vibe site 

* Create initial workspaces and populate them with information that is of interest to Vibe users 

¢ Control user access to workspaces and folders 


+ Configure e-mail integration, so that Vibe users can receive notifications of updated information 
on the Vibe site and post to the Vibe site by using e-mail messages 


* Setup mirrored folders to make large sets of data that are already available on disk more easily 
available through the Vibe site 


* Set up software extensions (add-ons) that enhance the power and usefulness of the Vibe site 


* Set up remote applications that deliver data from a remote location, such as a remote database, 
for easy access on your Vibe site 


* Manage users, workspaces, and folders as the Vibe site grows and evolves 


+ Perform regular backups to safeguard the data stored in the Vibe site 


The typical tasks performed by Vibe site administrators are covered in the Novell Vibe 3.4 
Administration Guide. 


Vibe Components 


A Novell Vibe site consists of four major components: 


¢ Section 1.2.1, “Vibe Software,” on page 16 
* Section 1.2.2, “Vibe Database,” on page 16 
* Section 1.2.3, “Vibe File Repository,” on page 17 


* Section 1.2.4, “Lucene Index,” on page 17 


Vibe Software 


The Vibe software is a customized version of Apache Tomcat. This software provides the Web-based 
functionality you use as you access the Vibe site through your Web browser. 


Vibe Database 


The Vibe database is used for storing information about the Vibe site and its users: 


¢ Structural information about workspaces, folders, and entries (for example, their location in the 
workspace tree) 
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1.2.4 


1.3 


¢ Identification information about workspaces, folders, and entries (for example, titles, 
descriptions, dates of creation/modification, and users associated with creation/modification) 


* User profile information (for example, full name, phone number, and e-mail address) 


The Vibe database disk space requirements are relatively modest, because the database is not used 
for storing files. 


Vibe File Repository 


The Vibe file repository holds all files that are imported into Vibe, information related to the imported 
files, such as thumbnails and HTML renderings, and the search engine index. 


The Vibe file repository disk space requirements depend on the size of the Vibe site. For a large Vibe 
site, disk space requirements can be substantial. 


Lucene Index 
The Lucene Index Server is a high-performance Java search engine. The Lucene index contains 


pointers to the actual data stored in the Vibe file repository. The index enables the Lucene search 
engine to perform very fast searches through large quantities of Vibe data. 


Vibe Configurations 


You can configure Novell Vibe to run on a single server or multiple servers, depending on the size and 
needs of your Vibe site. 


Configuration Description 

Single Server By default, the Vibe Installation program installs all Vibe components on the same 
server. 

Remote Database For better performance and scalability, you can install the Vibe database on a remote 

Server server. 


Remote Lucene Index For better performance and scalability, you can install the Lucene index on a remote 
Server server. 


Multiple Vibe Servers By running Novell Vibe on multiple servers, you can achieve high availability, including 
failover and load balancing, depending on how you configure your servers. 


Multiple Remote Your Novell Vibe site depends on the Lucene Index Server for full functionality. 

Lucene Servers Running multiple Lucene Index Servers provides high availability, so that if one Lucene 
Index Server goes down, Vibe users can still access the Vibe site because other 
Lucene Index Servers are still available. 


Multiple Remote Each of the three databases supported by Vibe each has its own approach to 
Database Servers clustering the database server. Information about clustering database servers is 
available on the Internet. 


For more information about which configuration type will best achieve the needs of your organization, 
see Section 2.6, “Recommended Hardware Configurations Based on System Performance,” on 
page 26. 


For more information about how to set up these configurations, see Part IV, “Multi-Server 
Configurations and Clustering,” on page 127. 
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2.1 


2.1.1 


Vibe System Requirements 


You, as a Novell Vibe site administrator, must ensure that your system meets Vibe system 
requirements, so that your Vibe site can be set up successfully. After your Vibe site is set up, you 
must ensure that users’ browsers and office applications meet Vibe user requirements, so that users 
can access the Vibe site successfully. 

* Section 2.1, “Vibe 3.4 HP2 Server Requirements,” on page 19 

* Section 2.2, “Vibe 3.4 Server Requirements,” on page 20 

* Section 2.3, “Vibe User Requirements,” on page 23 

* Section 2.4, “Mobile Requirements,” on page 23 

* Section 2.5, “Supported Environments,” on page 24 

* Section 2.6, “Recommended Hardware Configurations Based on System Performance,” on 

page 26 


For the latest system requirements details, see the Novell Vibe 3.4 Readme (http://www.novell.com/ 
documentation/vibe34/vibe34_readme_novell/data/vibe34_readme_novell.html). 


Vibe 3.4 HP2 Server Requirements 


Installing Vibe 3.4 Hot Patch 2 (HP2) requires the following: 


¢ Section 2.1.1, “Java Developer Kit (JDK) Requirements,” on page 19 
* Section 2.1.2, “Java Cryptography Extension (JCE) Requirements,” on page 20 


* Section 2.1.3, “Tomcat Requirements,” on page 20 


Java Developer Kit (JDK) Requirements 


Platform Requirement 


Linux * IBM JDK (latest version) 


Java scripting must be enabled for proper Vibe site functionality. 


* Oracle JDK (latest version) 


Windows * Oracle JDK (latest version) 


More information about JDKs is available in Section A.1, “Java Development Kit (JDK),” on page 221 
in Appendix A, “Vibe 3.4 HP2 System Requirements Assistance,” on page 221. 
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2.1.2 


2.1.3 


2.2 


2.2.1 


Java Cryptography Extension (JCE) Requirements 


Platform Requirement 
Linux + Unrestricted SDK JCE policy files 
Windows + Unrestricted SDK JCE policy files 


More information about JDKs is available in “Java Cryptography Extension (JCE)” in Appendix A, 
‘Vibe 3.4 HP2 System Requirements Assistance,” on page 221. 


Tomcat Requirements 


Requirement Additional Information 
Tomcat 7.0.55 Tomcat 7.0.55 is included with Vibe on Linux and Windows. 
TrueType fonts If you are installing Vibe in a non-GUI Linux environment, you might need to 


manually install the TrueType fonts if they are not already installed. TrueType 
fonts enable Stellent converters to function properly for document conversions. 
For more information, see “Understanding and Configuring Document 
Conversions with Stellent” in the Novell Vibe 3.4 Administration Guide. 


Vibe 3.4 Server Requirements 


* Section 2.2.1, “Hardware,” on page 20 

* Section 2.2.2, “Operating Systems,” on page 21 
* Section 2.2.3, “Database,” on page 21 

* Section 2.2.4, “JDK,” on page 21 

* Section 2.2.5, “Tomcat,” on page 22 

* Section 2.2.6, “Directory Service,” on page 22 

* Section 2.2.7, “Disk Space,” on page 22 

¢ Section 2.2.8, “Other,” on page 23 


Hardware 


The following hardware for the Novell Vibe server: 


* x86-32 processor or x86-64 processor 

* Minimum 2 GHz processor 

* Multi-CPU systems preferred 

* Minimum server memory: 
+ Atleast 3 GB RAM for an x86-32 processor 
+ Atleast 4 GB RAM for an x86-64 processor 


See Section 2.6, “Recommended Hardware Configurations Based on System Performance,” on 
page 26 and Section 3.2.3, “Vibe Server Memory,” on page 37. 
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2.2.2 Operating Systems 


Any of the following supported server operating systems for the Vibe server: 


* Novell Open Enterprise Server (OES) 2, plus the latest Support Pack 
* Novell Open Enterprise Server 11, plus the latest Support Pack 
* SUSE Linux Enterprise Server (SLES) 10 or SLES 11, plus the latest Support Pack 


NOTE: On SLES, the X Window System is required by the GUI Vibe installation program. It is 
not required to run Vibe after installation. It is not required for text-based installations or silent 
installations. 


* Windows Server 2003, Windows Server 2008, or Windows Server 2012, plus the latest Service 
Pack 


* Windows Server 2003R2 or Windows Server 2008R2, plus the latest Service Pack 


See Section 2.5.4, “Virtualization Support,” on page 25 for information about support for running Vibe 
in a virtualized environment. 


2.23 Database 


One of the following database servers: 
* Linux: 


* MySQL 5.0.26 - MySQL 5.5 server and client (MySQL 5.6 is not supported) 


NOTE: MySQL is included with SLES, but you do need to install and configure it. For more 
information, see Section B.2.1, “MySQL on Linux,” on page 228. 


* Oracle 10g or Oracle 11g 
* Windows: 
* MySQL 5.0.26 or later server and tools 
+ Microsoft SQL Server 2005 or SQL Server 2008, plus the latest Service Pack 
* Microsoft SQL Server 2008R2, plus the latest Service Pack 
* Oracle 10g or Oracle 11g 


More information about MySQL is available in Section B.2, “MySQL Database Server,” on page 228. 


2.2.4 JDK 


One of the following Java Developer Kits (JDKs): 
* Oracle JDK 6.0 and Oracle JDK 7.0 with the latest update (Oracle JDK 6.0 is supported on both 
Windows and Linux; Oracle JDK 7.0 is supported only on Windows) 
* IBM JDK 6.0 and IBM JDK 7.0 with the latest update (Supported only on Linux) 
Java scripting must be enabled for proper Vibe site functionality. 


More information about JDKs is available in “Java Development Kit” in Appendix B, “Vibe 3.4 
System Requirements Assistance,” on page 225. 
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2.2.5 Tomcat 


+ Tomcat 6.0.35 


NOTE: Tomcat 6.0.35 is included with Vibe on Linux and Windows. 


2.2.6 Directory Service 


One of the following directory services: 


* Linux: Novell eDirectory 8.8 or later, plus the latest Support Pack 


For information about eDirectory, see the Novell eDirectory 8.8 Documentation Web site (http:// 
www.novell.com/documentation/edir88). 


Windows: Microsoft Active Directory, plus the latest Service Pack, or Novell eDirectory 8.8 or 
later, plus the latest Support Pack 


For information about Active Directory, see Windows Server 2003 Active Directory (http:// 
www.microsoft.com/windowsserver2003/technologies/directory/activedirectory) or Windows 
Server 2008 Active Directory (http://\www.microsoft.com/windowsserver2008/en/us/active- 
directory.aspx). 


Disk Space 


Adequate server disk space: 


+ Vibe software: At least 500 MB for a new installation 


When you update an existing Vibe system, ensure that your server has at least twice the amount 
of disk space available as is in the following directory, plus an additional 500 MB: 
Linux: /var/opt/novell/teaming 


Windows: c:\Program Files\Novell\Teaming 


Database server software: At least 500 MB for a new installation 


When you update an existing Vibe system, ensure that your server has at least twice the amount 
of disk space available as is in the following directory, plus an additional 500 MB: 


Linux: /var/opt/novell/teaming 


Windows: c:\Program Files\Novell\Teaming 


Vibe file repository: Depends on the anticipated size of the Vibe site 
Database content: Substantially less than the Vibe file repository 


See Section 3.6, “Planning the Vibe Database,” on page 44 to plan for the disk space needs of 
your Vibe site. 
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2.2.8 Other 


* TrueType fonts 


If you are installing Vibe in a non-GUI Linux environment, you might need to manually install the 
TrueType fonts if they are not already installed. TrueType fonts enable Stellent converters to 
function properly for document conversions. For more information, see “Understanding and 
Configuring Document Conversions with Stellent” in the Novell Vibe 3.4 Administration Guide. 


2.3 Vibe User Requirements 


* Web browser: 
¢ Linux: Mozilla Firefox 3 or later; Google Chrome (latest version) 


* Windows: Microsoft Internet Explorer 6 or later (must not have the Google Chrome Frame 
plug-in installed); Mozilla Firefox 3 or later; Google Chrome (latest version) 


When you use Internet Explorer 6, some functionality might not be available. 
* Mac: Safari 4 or later; Mozilla Firefox 3 or later 
* Office applications: 
* Linux: OpenOffice.org/LibreOffice 3.1.1 or later 
* Windows: Microsoft Office 2007 or later; OpenOffice.org/LibreOffice 3.1.1 or later 
* Mac: OpenOffice.org/LibreOffice 3.1.1 or later 


NOTE: OpenOffice and LibreOffice are used synonymously throughout the Novell Vibe 
documentation. Functionality and issues that apply to OpenOffice also apply to LibreOffice. 


¢ Collaboration clients: 

¢ Linux: 
+ GroupWise 2012 with the latest Support Pack 
+ GroupWise 8 with the latest Support Pack 

* Windows: 
+ GroupWise 2012 with the latest Support Pack 
+ GroupWise 8 with the latest Support Pack 
* Outlook 2007 with iCal support enabled 
* Notes 7 with iCal support enabled 


2.4 Mobile Requirements 


You can download a native application for your iPhone, iPad, Android, or BlackBerry device. These 
applications have a more polished user interface and don’t require you to sign in each time you 
access Vibe. However, the mobile app for Vibe does not store information on your device; information 
can be viewed only when you have an Internet connection. 


Other devices can access the Vibe mobile interface by using a mobile browser that meets the 
requirements listed in Section 2.4.2, “Mobile Browser Requirements,” on page 24. 


* Section 2.4.1, “Mobile App Requirements,” on page 24 


* Section 2.4.2, “Mobile Browser Requirements,” on page 24 
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2.4.1 Mobile App Requirements 


Novell Vibe mobile apps are available for the following mobile operating systems: 


¢ iOS (native application is available for both the iPhone and iPad for a free download in the Apple 
App Store--for iOS 6 or later) 


* Android (native application is available for a free download in the Google Play App Store-- 
formerly known as the Android Market--for Android 2.2 or later) 


¢ Kindle Fire (native application is available for a free download in the Amazon Appstore for 
Android) 


* BlackBerry Z10 and PlayBook (native application is available for a free download in the 
BlackBerry World store) 


Ensure that your device’s browser meets the requirements that are discussed in Section 2.4.2, 
“Mobile Browser Requirements,” on page 24. 


2.4.2 Mobile Browser Requirements 


To access Vibe from a browser on a mobile device, your device’s browser must support: 


* HTML 4 


* JavaScript 


NOTE: The BlackBerry Curve has issues with JavaScript, so it does not work with the Vibe mobile 
interface. For more information, see “Your BlackBerry Curve Does Not Work with the Mobile 
Interface” in “Troubleshooting” in the Novell Vibe 3.4 User Guide. 


2.5 Supported Environments 


¢ Section 2.5.1, “File Viewer Support,” on page 24 

¢ Section 2.5.2, “IPV6 Support,” on page 25 

¢ Section 2.5.3, “Clustering Support,” on page 25 

* Section 2.5.4, “Virtualization Support,” on page 25 

* Section 2.5.5, “Single Sign-On Support,” on page 25 

* Section 2.5.6, “Linux File System Support,” on page 25 


2.5.1 File Viewer Support 


In Novell Vibe, file viewing capabilities are provided by Oracle Outside In viewer technology. See 
“Oracle Outside In Technology 8.3 Supported Formats” (http://www.oracle.com/us/026956.pdf) for a 
list of the supported file formats. See “Oracle Outside In Technology” (http://www. oracle.com/ 
technologies/embedded/outside-in.html) for background information about the Oracle viewer 
technology included in Vibe. 


The file viewers also support data indexing by the Lucene Index Server. 
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2.5.2 


2.5.3 


2.5.4 


2.5.9 


2.5.6 


IPV6 Support 


Novell Vibe supports the IPV6 protocol when it is available on the server. If the protocol is available, 
Vibe detects it and supports IPV6 by default, along with IPV4. 


Clustering Support 


You can install Vibe components on multiple servers to provide failover support, as described in 
Part IV, “Multi-Server Configurations and Clustering,” on page 127. 


Virtualization Support 


You can install Vibe in virtual environments where a software program enables one physical server to 
function as if it were two or more physical servers. 


Novell tests the Vibe software on both Xen and VMware platforms. Vibe is supported on these 
platforms, as well as other virtualization platforms, such as Microsoft Hyper-V. If you encounter an 
issue that cannot be duplicated in a Novell test environment, you may be responsible for following up 
with the provider of your virtualization software. 


For more information about XEN virtualization support, see Open Enterprise Server 2 Virtualization 
Documentation Web site (http://www.novell.com/documentation/oes11/ 
virtualization.html#virtualization) and SLES Virtualization Technology Documentation Web site (http:// 
www.novell.com/documentation/vmserver). 


For more information about VMware virtualization support, see VMWare Web site (http:// 
www.vmware.com). 


Single Sign-On Support 
Novell Access Manager can be used to provide single sign-on capabilities for your Vibe site. For 


setup instructions, see Section 9.9, “Configuring Single Sign-On with Novell Access Manager,” on 
page 103. 


Linux File System Support 


The following file systems are supported for Vibe running on Linux: 


* ext3 (recommended in most cases) 


NOTE: The maximum number of file entries in a Vibe File folder cannot exceed 31,998 when 
using the ext3 file system. 


+ NSS (recommended if you are running OES Linux and need the feature-rich environment of 
NSS) 


+ reiser3 
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2.6 


2.6.1 


Recommended Hardware Configurations Based 
on System Performance 


Because of the wide variety of ways you can use Vibe, the recommendations given in this section are 
only guidelines. 


The hardware configuration that you set up for your Novell Vibe site should be based on the following 
considerations: 


* Number of active users that the Vibe site must support: Users who have accounts in the 
Vibe system but do not log in to the system should not be considered in this number. For 
example, if there are 1,000 users in the Vibe system but only 300 access the system on a regular 
basis, the number of active users is 300. 


* Content the users will add: The type of content that is shared and stored on your Vibe site. 
The number of active users in the system is a good indicator of what the hardware configuration 
of your system should be, but you should also keep in mind that the type of content that is 
shared and stored on your Vibe site has a significant effect on the amount of disk space and 
memory that is required. 


For example, your users might add the following types of content: 


* Multimedia documents, such as CAD and PowerPoint documents (requires the most 
system resources) 


* Other documents, such as text documents and photos 
* Vibe entries that do not contain attachments, such as blog entries and discussion entries 
(requires the least amount of system resources) 


For example, if you have a Vibe installation with only 400 active users, but those users often upload 
and share CAD files, you might want to configure a dedicated SQL server where those files can be 
stored, as well as a larger CPU, increased memory, and a larger Java heap to more efficiently upload 
and search for the files. 


Server machines can be physical or virtual. 


* Section 2.6.1, “Configuration Based on Installation Size,” on page 26 
* Section 2.6.2, “Test Installation,” on page 27 

* Section 2.6.3, “Small Installation,” on page 28 

* Section 2.6.4, “Medium Installation,” on page 29 

* Section 2.6.5, “Large Installation,” on page 30 


* Section 2.6.6, “Very Large Installation,” on page 31 


Configuration Based on Installation Size 


The following table shows the recommended hardware configuration based on the size of the Vibe 
installation. For more detailed information about each type of installation, click the installation size in 
the column header. 


Test Installation Small Medium Large Very Large 
Installation Installation Installation Installation 
Single Server X X 


Only 
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2.6.2 


Remote 
Database 
Server 


Remote Vibe 
Desktop 
Server 


Remote Vibe 
Add-In or 
WebDAV 
Server 


Remote Lucene 
Index Server 


Remote File 
Repository 


Multiple Vibe 
(Tomcat) 
Servers 


Multiple 
Remote Lucene 
Servers 


Multiple 
Remote 
Database 
Servers 


Multiple 
Remote Vibe 
Desktop 
Servers 


Multiple 
Remove Vibe 
Add-In Servers 


Test Installation Small 
Installation 


Test Installation 


Tomcat 
Lucene Index 
SQL Database 
File System 
Vibe Desktop 


Medium 
Installation 


X 


Large Very Large 
Installation Installation 
X 
x X 
x X 

x 
x X 

x 

x 


Vibe System Requirements 


27 


This deployment is suitable for a single-person evaluation or minimal usage by a small group. 


Vibe Components CPU Memory Java Heap 


1 dedicated Vibe (Tomcat) server with: 3Ghz x86 or x64, single- 4-8 GB 2-6 GB 


+ 


core or dual-core 
Lucene 


SQL 
File System 
Vibe Desktop 
Vibe Add-In 


For more information about installing a basic, single-server Vibe site, see Part Il, “Basic Installation,” 
on page 33. 


You can perform a Basic installation to set up a single-server configuration, as described in 
Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and Chapter 4, “Installing and Setting Up 
a Basic Vibe Site,” on page 61. 


2.6.3 Small Installation 


Tomcat Tomcat 

Lucene Index (for Vibe Desktop 
SQL Database if more than 100 
File System active users) 


This deployment is suitable for a workgroup, department, or small company. All components are on a 
single server but are running typical memory allocations. If Vibe Desktop is being used with more 
than 100 active users, it must be running on one or more separate Vibe (Tomcat) servers. 


Vibe Components CPU Memory Java Heap 


Multiple Vibe servers: 3Ghz x86 or x64, dual- 4-8 GB 2-6 GB 


core or quad-core 


+ 1 dedicated Vibe (Tomcat) server 


with SQL, and file system 


1 dedicated Vibe (Tomcat) server 
with Vibe Desktop for 100 or fewer 
active users; 2 dedicated Vibe 
(Tomcat) servers with Vibe Desktop 
for more than 100 active users 


For more information about installing a basic, single-server Vibe site, see Part Il, “Basic Installation,” 
on page 33. 
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2.6.4 


For more information on how to configure Vibe Desktop to run on your Vibe server, as well as how to 
distribute Vibe Desktop synchronization traffic to a dedicated Vibe server, see “Configuring Vibe 
Desktop and the Microsoft Office Add-In” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 


You can perform a Basic installation to set up a single-server configuration, as described in 
Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and Chapter 4, “Installing and Setting Up 
a Basic Vibe Site,” on page 61. 


Medium Installation 


my SR 


Tomcat Tomcat Tomcat 
(for Vibe Desktop) Lucene Index (for Vibe Desktop 
File System if more than 100 


active users) 


This deployment is suitable for a medium-to-large business. The database server is separate, to 
increase the amount of parallel processing in the system. The database can be a single server ora 
cluster of database servers. More memory is also allocated to the Vibe server. If Vibe Desktop is 
being used with more than 100 active users, it must be running on multiple separate Vibe (Tomcat) 
servers. 


Vibe Components CPU Memory Java Heap 
Multiple Vibe servers: 3Ghz x86 or x64 quad- 4-8 GB 6 GB 
core 


+ 1 dedicated Vibe (Tomcat) server 
with file system 


+ 1 or more dedicated SQL servers 


+ 2or more dedicated Vibe (Tomcat) 
servers with Vibe Desktop 


For information on how to create a separate Vibe database, follow the instructions specific to your 
database type, as described in Chapter 13, “Creating the Vibe Database on a Remote Server,” on 
page 129. 


For more information on how to configure Vibe Desktop to run on your Vibe server, as well as how to 
distribute Vibe Desktop synchronization traffic to a dedicated Vibe server, see “Configuring Vibe 
Desktop and the Microsoft Office Add-In” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 


You can perform a Basic installation to set up a multiple-server configuration (as described in 
Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and Chapter 4, “Installing and Setting Up 
a Basic Vibe Site,” on page 61); however, the remote database must be created manually and in 
advance of performing the installation, as described in Chapter 13, “Creating the Vibe Database ona 
Remote Server,” on page 129. 
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2.6.5 Large Installation 


kE wy 


Tomcat Tomcat SQL database 


(for Vibe Desktop) / \ 


File System Lucene Index 


This deployment is suitable for a large business. This deployment uses load balancing across all 
servers. The database server is separate, to increase the amount of parallel processing in the 
system. The index server is separate, to allow the application to better utilize the physical memory 
that is allocated. The file system is separate, and a SAN file system is recommended. The memory 
utilization of the index server is proportional to the index size, which is directly related to the number 
and size of documents and entries that are stored. As the number and size of documents and entries 
that are stored increases, you should increase the amount of memory accordingly. If Vibe Desktop is 
being used with more than 100 active users, it must be running on multiple separate Vibe (Tomcat) 
servers. 


Vibe Components CPU Memory Java Heap 
Multiple Vibe servers: 3Ghz x64 quad-core or 8- 4-8 GB 6 GB 
core 


* 3-5 dedicated Vibe (Tomcat) 
servers 


+ 2-4 dedicated Lucene servers 
+ 2 dedicated SQL servers 


+ 1 dedicated file system server (SAN 
is recommended) 


+ 2 or more dedicated Vibe (Tomcat) 
servers with Vibe Desktop 


For more information on load balancing, see Section 15.3, “Configuring a Web Application to Provide 
High Availability Functionality for Your Vibe Site,” on page 142. 


For information on how to create a separate Vibe database, follow the instructions specific to your 
database type, as described in Chapter 13, “Creating the Vibe Database on a Remote Server,” on 
page 129. 


For information on how to create a separate index server, see Chapter 14, “Installing the Lucene 
Index Server on a Remote Server,” on page 135. 


For more information on how to create a separate file system server, see Section 15.1.2, “Vibe File 
Repository Considerations,” on page 139. 
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2.6.6 


For more information on how to configure Vibe Desktop to run on your Vibe server, as well as how to 
distribute Vibe Desktop synchronization traffic to a dedicated Vibe server, see “Configuring Vibe 
Desktop and the Microsoft Office Add-In” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 


You must perform an Advanced installation to achieve this type of deployment. For more information, 
see Part III, “Advanced Installation and Reconfiguration,” on page 93. 


Very Large Installation 


E gs 


Tomcat Tomcat SQL database 


(for Vibe Desktop) / \ 


File System Lucene Index 


This deployment is suitable for a large business. This deployment uses load balancing across all 
servers. The database server is separate, to increase the amount of parallel processing in the 
system. The index server is separate, to allow the application to better utilize the physical memory 
that is allocated. The file system is separate, and a SAN file system is recommended. The memory 
utilization of the index server is proportional to the index size, which is directly related to the number 
and size of documents and entries that are stored. As the number and size of documents and entries 
that are stored increases, you should increase the amount of memory accordingly. If Vibe Desktop is 
being used with more than 100 active users, it must be running on multiple separate Vibe (Tomcat) 
servers. 


Vibe Components CPU Memory Java Heap 
Multiple Vibe servers: 3Ghz x64 quad-core or 8- 4-8 GB 6GB 
core 


* 4-8 dedicated Vibe (Tomcat) 
servers 


+ 2-4 dedicated Lucene servers 
* 2 dedicated SQL servers 


+ 1 dedicated file system server (SAN 
is recommended) 


+ 2 or more dedicated Vibe (Tomcat) 
servers with Vibe Desktop 


For more information on load balancing, see Section 15.3, “Configuring a Web Application to Provide 
High Availability Functionality for Your Vibe Site,” on page 142. 
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For information on how to create a separate Vibe database, follow the instructions specific to your 
database type, as described in Chapter 13, “Creating the Vibe Database on a Remote Server,” on 
page 129. 


For information on how to create a separate index server, see Chapter 14, “Installing the Lucene 
Index Server on a Remote Server,” on page 135. 


For more information on how to create a separate file system server, see Section 15.1.2, “Vibe File 
Repository Considerations,” on page 139. 


For more information on how to configure Vibe Desktop to run on your Vibe server, as well as how to 
distribute Vibe Desktop synchronization traffic to a dedicated Vibe server, see “Configuring Vibe 
Desktop and the Microsoft Office Add-In” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 


You must perform an Advanced installation to achieve this type of deployment. For more information, 
see Part III, “Advanced Installation and Reconfiguration,” on page 93. 
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Basic Installation 


* Chapter 3, “Planning a Basic Vibe Installation,” on page 35 

¢ Chapter 4, “Installing and Setting Up a Basic Vibe Site,” on page 61 
* Chapter 5, “Adding Users to Your Vibe Site,” on page 75 

* Chapter 6, “Updating Your Vibe License,” on page 83 

* Chapter 7, “Setting Up Vibe,” on page 85 


* Chapter 8, “Basic Vibe Installation Summary Sheet,” on page 87 
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3 Planning a Basic Vibe Installation 


The installation program for Novell Vibe helps you install the Vibe software and file repository to the 
appropriate locations. 

* Section 3.1, “What Is a Basic Vibe Installation?,” on page 35 

* Section 3.2, “Selecting the Operating Environment for Your Vibe Server,” on page 36 

* Section 3.3, “Selecting a Java Development Kit,” on page 39 

¢ Section 3.4, “Gathering Network Information for Your Vibe Site,” on page 39 

¢ Section 3.5, “Planning the WebDAV Authentication Method,” on page 42 

* Section 3.6, “Planning the Vibe Database,” on page 44 

¢ Section 3.7, “Gathering Outbound E-Mail Information,” on page 47 

¢ Section 3.8, “Enabling Inbound E-Mail,” on page 49 

* Section 3.9, “Planning Site Security,” on page 51 

* Section 3.10, “Gathering Directory Services Information,” on page 51 


* Section 3.11, “Accommodating Multiple Languages,” on page 58 


3.1 Whatlsa Basic Vibe Installation? 


The Novell Vibe installation program provides two installation types: Basic and Advanced. When you 
perform a Basic installation, the result is a fully functional Vibe site with all required options configured 
and with typical defaults in use for optional settings. 


If you are new to Vibe, the easiest way to get started is to perform a Basic installation first, with all 
Vibe components installed on the same server, then add advanced configuration options to your Vibe 
site after the Basic installation has been successfully tested. However, experienced Vibe 
administrators can choose to perform an Advanced installation immediately, which includes all 
installation and configuration options, as described in Part III, “Advanced Installation and 
Reconfiguration,” on page 93. 


IMPORTANT: The following Vibe configurations require that you perform an Advanced installation as 
your initial installation of the Vibe software: 


* Setting up the Vibe file repository so that some types of files are located outside the Vibe file 
repository root directory. See Section 9.2, “Distributing Different Data Types to Different 
Locations,” on page 96 for Advanced installation instructions. You cannot move subdirectories 
within the Vibe file repository after they have been created. 


¢ Installing the Vibe software on multiple servers to create a clustered environment. See 
Chapter 15, “Running Vibe on Multiple Servers,” on page 139 for Advanced installation 
instructions. The option to enable a clustered environment is available only during an Advanced 
installation. 


If you want to implement an Advanced installation option, you should perform a Basic installation first, 
in a test environment, before performing the Advanced installation to set up your permanent Vibe site. 
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3.2 


3.2.1 


3.2.2 


This section helps you make informed decisions about the required options for a Basic installation: 


¢ Server platform (Linux or Windows) 

¢ Server architecture (32-bit or 64-bit) 

* Physical server memory requirements 

¢ File locations (Vibe software and data) 

* Java Development Kit (JDK) version (Sun or IBM) 

* Database type (MySQL, Microsoft SQL Server, or Oracle) 

* Database creation (during installation or before installation) 

* Database authentication (username and password) 

* Network information (Vibe server hostname or fully qualified domain name, and ports) 


+ Outbound e-mail configuration (SMTP vs. SMTPS, hostname, SMTP port, time zone, 
authentication) 


* Inbound e-mail configuration (SMTP address, SMTP port, and TLS support) 


* User and group for running the Vibe software (Linux only) 


Before performing a Basic installation, make sure all system requirements are met, as listed in 
Chapter 2, “Vibe System Requirements,” on page 19. 


As you proceed with planning, you can use the Basic Vibe Installation Summary Sheet to record your 
decisions about the options you want to use. 


Selecting the Operating Environment for Your 
Vibe Server 


* Section 3.2.1, “Vibe Server Platform,” on page 36 

* Section 3.2.2, “Vibe Server Architecture,” on page 36 
* Section 3.2.3, “Vibe Server Memory,” on page 37 

* Section 3.2.4, “Vibe Installation Locations,” on page 38 


* Section 3.2.5, “TrueType Font Location (Linux Only),” on page 39 


Vibe Server Platform 


Novell Vibe can run on the versions of Linux and Windows listed in Section 2.2, “Vibe 3.4 Server 
Requirements,” on page 20. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Vibe Server Platform, mark your operating system of choice. 


Vibe Server Architecture 


Vibe can run on 32-bit or 64-bit processors. A 64-bit processor is recommended for a large Vibe site 
where the processor load is heavy and data storage requires a large amount of disk space. 
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3.2.3 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Processor Architecture, mark the processor capacity required for the size of Vibe site that you 
want to set up. 


Vibe Server Memory 


If a 32-bit processor is sufficient for your Vibe server, the server needs at least 3 GB of memory. If you 
plan to use a 64-bit processor in your Vibe server, the server needs more. 


Vibe server memory usage is significantly affected by some factors and less affected by others: 


* Number of users logged in: No significant effect. 
* Number of concurrent active sessions: No significant effect. 
¢ Database server caches: Significant memory usage. 


When you follow the instructions for a Basic installation, the database is located on the same 
server as the Vibe software. After you have successfully tested your Basic installation, you can 
reconfigure Vibe to have its database on a remote server, so that the database uses separate 
memory resources, as described in Chapter 13, “Creating the Vibe Database on a Remote 
Server,” on page 129. 


¢ Vibe internal data caches: Significant memory usage. 


When you follow the instructions for a Basic installation, the Vibe internal data caches are 
subdirectories of the teamingdata directory, described in Section 3.2.4, “Vibe Installation 
Locations,” on page 38. The Vibe internal data caches are separate from any caching or memory 
usage by the database server itself. 


+ Lucene index cache: Significant memory usage. 


The Lucene Index Server is a high-performance Java search engine. Large file repositories 
(particularly with large files or a large number of files) can create a very large data index. When 
you perform a Basic installation, the Lucene index is created on the same server where the Vibe 
software is installed. After you have successfully tested your Basic installation, you can 
reconfigure Vibe to have its Lucene index on a remote server, so that it uses separate memory 
resources, as described in “Installing the Lucene Index Server on a Remote Server” on 

page 135. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Memory Requirements, specify the amount of physical memory you plan to have for your Vibe 
server. 


When you perform a Basic installation, the default amount of memory allocated to the Java Virtual 
Machine (JVM) where the Vibe software runs is 1 GB, which is adequate for a medium-sized Vibe site 
running on a 32-bit server. This memory allocation, called the Java “heap size,” does not include 
memory used by your database server or by the Lucene Index Server when these programs are 
running on the same server as the Vibe software. 


A general rule is that no more than 75% of the available physical memory should be allocated to the 
JVM. Memory not allocated to the JVM must be sufficient to support the operating system, the 
database server, and the Lucene Index Server if they are also running on the Vibe server, and any 
other processes running on the Vibe server. 
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3.2.4 


IMPORTANT: A JVM on a 32-bit server should not be configured to take more than 1.5 G of memory. 
However, large numbers of users and documents often need memory settings higher than 2 GB to 
provide adequate performance. This type of Vibe system should be set up on 64-bit hardware. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location, specify the amount of memory to allocate to the JVM where Vibe runs. 


Although it is possible to run Vibe with less than 1 GB of memory for the JVM, this applies only to very 
small test configurations, and is not suitable for production systems. In a test configuration, 512 MB is 
the minimum amount of memory required to produce a functioning Vibe installation. 


Vibe Installation Locations 


The default file location for the Vibe software varies by platform: 


Linux: /opt/novell/teaming 


Windows: c:\Program Files\Novell\Teaming 


Included under the main Vibe software directory are subdirectories for Tomcat and file viewer 
software. 


The default file location for the Vibe file repository also varies by platform: 


Linux: /var/opt/novell/teaming 


Windows: c:\Novell\Teaming 


IMPORTANT: On Windows, the Vibe installation program displays the Windows pathname with 
forward slashes (/) rather than the traditional backslashes (\). This syntax is necessary in the 
installation program. 


The Vibe file repository holds all files that are imported into Vibe, information related to the imported 
files, such as thumbnails and HTML renderings, and the search engine index. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under File Locations, specify the directories where you want to install the Vibe software and data if you 
prefer not to use the default locations. 


A Basic installation allows you to change the root directory for the Vibe software and the Vibe file 
repository. 


IMPORTANT: If you want to organize the Vibe file repository so that some file types are not under the 
Vibe file repository root directory, you must perform an Advanced installation as your initial Vibe 
installation. You cannot move directories out of the Vibe file repository root directory after the initial 
installation has been performed. To perform an Advanced installation in order to organize the Vibe file 
repository to meet your needs, complete the planning steps for a Basic installation and complete the 
Basic Vibe Installation Summary Sheet, then follow the additional instructions in Section 9.2, 
“Distributing Different Data Types to Different Locations,” on page 96. 
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3.2.5 


3.3 


3.4 


TrueType Font Location (Linux Only) 


The Oracle Outside In viewer technology used by Novell Vibe to render various file formats into 
HTML for viewing requires access to TrueType fonts. Typical locations for these fonts are: 


/usr/X11R6/lib/X11/fonts/truetype 
/usr/share/fonts/truetype 


If the TrueType font location is not correct, thumbnails are not displayed correctly on the Vibe site. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under TrueType Font, specify the directory that contains the TrueType font location. 


Selecting a Java Development Kit 


As listed in Section 2.2, “Vibe 3.4 Server Requirements,” on page 20, you need to install a Java 
Development Kit (JDK) before you install Novell Vibe. You can use either the Sun JDK or the IBM 
JDK for the platform where you are installing Vibe (Linux or Windows). 


If you want to use an SSL connection between your Novell Vibe site and a WebDAV server, and if the 
WebDAV server has a self-signed certificate rather than a certificate provided by a certificate 
authority, you must use the Sun JDK. The existing Vibe functionality for handling self-signed 
certificates is not compatible with the way the IBM JDK handles self-signed certificates. 

BASIC VIBE INSTALLATION SUMMARY SHEET 

Under Java Development Kit, mark the JDK that you want to use with Vibe. 

You must install the JDK on the Vibe server before you install the Vibe software. If you are not familiar 
with installing a JDK, see “Java Development Kit” in Appendix B, “Vibe 3.4 System Requirements 
Assistance,” on page 225 for instructions. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java Development Kit, specify the directory where you have installed the JDK. 


The Vibe Installation program uses this path as if you had set the JAVA_HOME environment variable. 
The path is stored for future reference in the installer.xml file so that you need to specify the path 
to the JDK only once. 


Gathering Network Information for Your Vibe Site 


When you perform a Basic installation, the Novell Vibe installation program needs hostname and 
HTTP port information about the server where you are installing Vibe. 


* Section 3.4.1, “Host Identification,” on page 40 
* Section 3.4.2, “Port Numbers,” on page 40 
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3.4.1 


3.4.2 


Host Identification 


When you install Vibe, the Vibe installation program needs to know the name of the server where you 
are installing the Vibe software. The default is localhost. Do not use the default. 


For internal use, you can use the DNS hostname of the Vibe server. However, if you want your Vibe 
site to be accessible from the Internet, you must specify the fully qualified domain name for the Vibe 
server in order to allow external access. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the hostname or fully qualified domain name to use for the Vibe 
server. 


Port Numbers 


When you install Vibe, Tomcat is installed along with the Vibe software. Vibe uses Tomcat as a 
standalone Web server for delivering data to Vibe users in their Web browsers. For more information 
about Tomcat, see the Apache Tomcat Web site (http://tomcat.apache.org). 


IMPORTANT: If the server where you want to install Vibe already has a Web server running on it, 
shut it down while you install and test Vibe. The instructions for a Basic Vibe installation assume that 
no other Web server is running on the Vibe server. If you want to maintain another Web server on the 
Vibe server, you are responsible for resolving any port conflicts that might arise. 


On the command line, use the netstat command to see what ports are currently in use on the server 
where you plan to install Vibe: 


Linux: netstat -tan 


Windows: netstat -a -n -p tcp 


Make sure that the port numbers that you specify during Vibe installation do not conflict with ports that 
are already in use on the server. 


+ “HTTP/HTTPS Ports” on page 40 

¢ “HTTP/HTTPS Ports When You Use Novell Access Manager with Vibe” on page 41 
¢ “Shutdown Port” on page 42 

+ “AJP Port” on page 42 


HTTP/HTTPS Ports 


By default, standard Web servers such as Apache and Microsoft Internet Information Services (IIS) 
use port 80 for non-secure HTTP (Hypertext Transfer Protocol) connections and port 443 for secure 
HTTPS connections. HTTPS connections use SSL (Secure Sockets Layer) for added security. As a 
result, Web browsers default to port 80 when no port is specified in a non-secure HTTP URL and to 
port 443 when no port is specified in a secure HTTPS URL. 


Tomcat defaults to port 8080 for non-secure HTTP connections and to port 8443 for secure HTTPS 
connections, so that it does not conflict with the standard Web server port numbers. If you configure 
Vibe with the Tomcat default port numbers, users must include the appropriate port number when 
providing the Vibe site URL. Typically, users prefer not to do this. 
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Unfortunately, the situation is not as simple as just configuring Vibe to use the default port numbers of 
80 and 443. On Linux, non-root processes are not allowed access to port numbers lower than 1024 
and you are counseled against running Vibe as root in Section 3.9.2, “Linux User ID for Vibe,” on 
page 51. Also on Linux and Windows, the default Tomcat installation expects ports 8080 and 8443. 


For a Basic installation, you can use the default port numbers as presented by the Vibe Installation 
program: 


HTTP port: 80 

Secure HTTP port: 443 
Listen port: 8080 
Secure listen port: 8443 


IMPORTANT: If you are installing Vibe on Novell Open Enterprise Server 2, port 80 is already in use 
by iManager. To have Vibe listen on port 80 (which is the standard port), you need to change 
iManager to listen on a non-standard port, such as 81. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, the default port numbers have been provided for you. You need to specify 
different port numbers only if you anticipate port conflicts with other software on the Vibe server. 
Resolving port conflicts is beyond the scope of this Vibe documentation. 


After you install Vibe on Linux, you need to complete the steps in “Setting Up Port Forwarding” on 
page 66 so that users are not required to include the port number in the Vibe URL. 


If you want to use secure HTTPS connections for your Vibe site, you must obtain signed certificate 
files as described in “Preparing for Secure HTTP Connections” in “Site Security” in the Novell Vibe 
3.4 Administration Guide either before or after you install Vibe. 


HTTP/HTTPS Ports When You Use Novell Access Manager with Vibe 


If you are fronting Vibe with Novell Access Manager, ensure that you have configured the HTTP/ 
HTTPS ports as described in the following sections, depending on the operating system where Vibe 
is running. 


Configuring Vibe in this way configures Novell Access Manager to access Vibe over port 80, which is 
the standard port. 


* “Windows Port Configuration” on page 41 
* “Linux Port Configuration” on page 42 


Windows Port Configuration 


Use the following port configuration when Novell Access Manager is fronting your Vibe system on 
Windows: 


HTTP Port: 80 
Secure HTTP Port: 443 
Listen Port: 80 


Secure Listen Port: 443 
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42 


3.5 


Linux Port Configuration 


Use the following port configuration when Novell Access Manager is fronting your Vibe system on 
Linux: 


HTTP Port: 80 

Secure HTTP Port: 443 
Listen Port: 8080 
Secure Listen Port: 8443 


With this suggested configuration on Linux, you also need to set up port forwarding, as described in 
Section 4.1.6, “Setting Up Port Forwarding,” on page 66. 


Shutdown Port 


By default, Vibe uses 8005 as its shutdown port. For an explanation of the shutdown port, see Tomcat 
- Shutdown Port (http://www.wellho.net/mouth/837_Tomcat-Shutdown-port.html). 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the port you want Vibe to use as its shutdown port if the default of 
8005 is already in use on the Vibe server. 


AJP Port 


By default, Vibe uses 8009 as its AJP port. For an explanation of the Apache JServ Protocol port, see 
The AJP Connector (http://tomcat.apache.org/tomcat-6.0-doc/config/ajp.html). 


IMPORTANT: If you are installing Vibe on Novell Open Enterprise Server 2, port 8009 is already in 
use, so you need to select a different port, such as 8010. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the port you want Vibe to use as its AJP port if the default of 8009 is 
already in use on the Vibe server. 


Planning the WebDAV Authentication Method 


¢ Section 3.5.1, “Understanding WebDAV,” on page 43 
* Section 3.5.2, “Choosing the WebDAV Authentication Method,” on page 43 
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3.5.1 


3.5.2 


Understanding WebDAV 


WebDAV is a standard collaborative editing and file management protocol. Novell Vibe relies on the 
WebDAV protocol for two key features: 


¢ Edit-in-Place for using tools such as OpenOffice and Microsoft Office, as described in “Editing 
Files” in the Novell Vibe 3.4 User Guide. 


¢ Mapping Vibe folders as a Web folder on the client computer, which allows access to Vibe files 
from a WebDAV-compliant file navigation tool such as Windows Explorer or Nautilus, as 
described in “Creating a Mapped Drive to the Vibe Folder” in the Novell Vibe 3.4 Advanced User 
Guide. 


IMPORTANT: When Vibe users are running Windows 7 as the client operating system, various 
issues can be introduced because of WebDAV limitations in Windows 7. If your Vibe users are using 
the Windows 7 operating system, see “Configuring Vibe to Support WebDAV on Windows 7” in the 
Novell Vibe 3.4 Administration Guide. 


Choosing the WebDAV Authentication Method 


The WebDAV authentication method determines how user credentials are passed from Vibe to the 
WebDAV server. Vibe 3 and later supports three types of WebDAV authentication methods: 


+ “Choosing Basic Authentication” on page 43 
+ “Choosing Digest Authentication” on page 43 


+ “Choosing Windows Authentication” on page 44 


Choosing Basic Authentication 


Basic authentication encodes the username and password with the Base64 algorithm. The Base64- 
encoded string is unsafe if transmitted over HTTP, and therefore should be combined with SSL/TLC 
(HTTPS). 


Select this type of authentication when you plan to use Novell Access Manager or Internet 
Information Services (IIS) to authenticate users. 


For more information about encryption algorithms, see Section 3.6.5, “Database Encryption 
Algorithm,” on page 46. 


Choosing Digest Authentication 


Digest authentication applies MD5 cryptographic, one-way hashing with usage of nonce values toa 
password before sending it over the network. This option is more safe than Basic Authentication 
when used over HTTP. 


Select this type of authentication when client users are using Windows 7 as their operating system 
and Microsoft Office as their text editor. 


For more information about encryption algorithms, see Section 3.6.5, “Database Encryption 
Algorithm,” on page 46. 
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3.6 


3.6.1 


Choosing Windows Authentication 


Windows Authentication provides Windows users with a single sign-on experience, enabling users to 
automatically authenticate to Vibe after they are logged in to their individual workstations. Internet 
Information Services (IIS) provides this capability. 


To configure Vibe to use Windows Authentication as the WebDAV authentication method, select basic 
in the WebDAV authentication method field during the Vibe installation program, then configure 
Windows Authentication as described in Section 9.10, “Configuring Single Sign-On with Internet 
Information Services for Windows,” on page 103. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under WebDAV authentication method, specify the authentication method you want Vibe to use when 
authenticating to WebDAV. 


Planning the Vibe Database 


Novell Vibe database disk space requirements are relatively modest. Files that are imported into Vibe 
are saved in the Vibe file repository, as described in Section 3.2.4, “Vibe Installation Locations,” on 
page 38. 


The Vibe database is primarily used for storing the following information: 


¢ Structural information about workspaces, folders, and entries (for example, their location in the 
workspace tree) 


¢ Identification information about workspaces, folders, and entries (for example, titles, 
descriptions, dates of creation/modification, and users associated with creation/modification) 


* User profile information (for example, full name, phone number, and e-mail address) 
You or your database administrator must make the following decisions about the Vibe database: 


¢ Section 3.6.1, “Database Type,” on page 44 

¢ Section 3.6.2, “Database Setup Method,” on page 45 
* Section 3.6.3, “Database Location,” on page 45 

* Section 3.6.4, “Database Credentials,” on page 46 


* Section 3.6.5, “Database Encryption Algorithm,” on page 46 


Database Type 


By default, Vibe uses open source MySQL as its database on Linux and on Windows. On Linux, Vibe 
also supports Oracle. On Windows, Vibe also supports Microsoft SQL Server and Oracle. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Type, mark the type of database that you want to use with Vibe. 


Make sure that a supported version of the database server, as listed in Section 2.2, “Vibe 3.4 Server 
Requirements,” on page 20, is installed and running before you install Vibe. 
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3.6.2 


3.6.3 


Database Setup Method 


If you plan to use a MySQL database, the Vibe installation program can automatically set up the 
database for you. This is the easiest way to get started. Before the database can be set up, you first 
need to install it and configure it on your server. For more information, see Section B.2, “MySQL 
Database Server,” on page 228. 


If you plan to use an Oracle database or a Microsoft SQL database, you must have your database 
administrator set up the database for you. Instructions for your database administrator are provided in 
Section 13.4, “Creating an Oracle Database,” on page 132 and Section 13.3, “Creating a Microsoft 
SQL Database,” on page 131. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Setup Method, mark whether you want the Vibe Installation program to automatically 
set up a MySQL database, or whether you need your database administrator to manually set up an 
Oracle database or Microsoft SQL database before you install Vibe. 


Database Location 


When you have the Vibe Installation program create the database for you, the database is created on 
the same server where you install the Vibe software. This is the preferable location for your Basic 
installation. The default database name is sitescape, a reference to the company that previously 
developed the Vibe software. 


Database Default Linux Location Default Windows Location 
Server 
MySQL /var/lib/mysql c:\Documents and Settings\All Users\ 


Application Data\MySQL\ 
MySQL Server version\Data 


Microsoft SQL N/A N/A 


Oracle N/A N/A 


You can have your database administrator create a database on a remote server later, after you have 
successfully tested your Basic installation. See Chapter 13, “Creating the Vibe Database on a 
Remote Server,” on page 129. 


If you need to have your database administrator create an Oracle or Microsoft SQL database, you 
must decide before installation whether you want the database on the Vibe server or on a remote 
server. See Section 13.4, “Creating an Oracle Database,” on page 132. 


Vibe knows where to find its database from the JDBC (Java Database Connectivity) URL that you 

provide during installation. For a database that is local to the Vibe software, the default JDBC URL 
that provides localhost as the hostname of the Vibe server is appropriate. If the database is on a 
remote server, the JDBC URL must provide the hostname of the remote database server. 


The JDBC URL also includes the port number on which Vibe can communicate with the database 
server. The default port number depends on the database server you are using: 
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3.6.4 


3.6.5 


Database Server Default Port Number 


MySQL 3306 
Microsoft SQL 1433 
Oracle 1521 


Use this port number unless it is already in use by another process on the database server. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under JDBC URL, specify the appropriate hostname for the database server (localhost or the 
hostname of a remote server) and the port number it will use to communicate with Vibe. 


Database Credentials 


When you have the Vibe Installation program create the database for you, it defaults to the following 
administrator usernames for the database server: 


Database Default Administrative Username 
MySQL root 


IMPORTANT: The MySQL root username is not the same as the Linux root user ona 
Linux server. 


Microsoft SQL (no default) For a Microsoft SQL database, your database administrator establishes the 
administrator username and password for the database server. 


Oracle (no default) For an Oracle database, your database administrator establishes the 
administrator username and password for the database server. 
For an Oracle database and Microsoft SQL database, your database administrator establishes the 


administrator username and password for the database server. 


Check with your database administrator to see if the default administrator username is still in use for 
your database server, and obtain the administrator password for the database server before you run 
the Vibe Installation program. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Credentials, specify the administrator username and password for the database server 
so that Vibe can access its database. 


Database Encryption Algorithm 


Different encryption algorithms provide differing encryption strength. The supported algorithms for 
encrypting the Vibe database password are listed below, in order from least strength to most strength. 


* MD5 
* SHA 
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3.7 


3.7.1 


This is the default option when you use Basic Authentication for WebDAV authentication, as 
described in Section 3.5, “Planning the WebDAV Authentication Method,” on page 42 


+ SHA-256 
* PBEWithMD5AndDES 


This is the only available option when you select Digest Authentication for WebDAV 
authentication, as described in Section 3.5, “Planning the WebDAV Authentication Method,” on 
page 42 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Encryption Algorithm, mark the encryption algorithm you want to use for Vibe 
passwords. 


Gathering Outbound E-Mail Information 


Your Novell Vibe site can be configured to send outbound e-mail through an existing e-mail system. 
E-mail from the Vibe site is useful for the following activities: 


* Vibe users can subscribe to e-mail notifications, so that they automatically receive a message 
whenever content of interest changes. For more information, see “Subscribing to a Folder or 
Entry” in “Getting Informed” in the Novell Vibe 3.4 User Guide. 


+ From the Vibe site, users can send e-mail messages to individual users or to teams. For more 
information, see “Sending E-Mail from within Vibe” in “Connecting With Your Co-Workers” in the 
Novell Vibe 3.4 User Guide. 


* If your e-mail client is iCal-enabled, appointments created in a Vibe Calendar folder can be sent 
to your e-mail client for posting in your e-mail client Calendar. For example, if you are using 
GroupWise, see “Accepting or Declining Internet Items” in “Calendar” in the GroupWise 8 
Windows Client User Guide. 


In order for your Vibe site to communicate with your e-mail system, you need to gather the following 
information about your e-mail system. 


* Section 3.7.1, “Outbound E-Mail Protocol,” on page 47 

* Section 3.7.2, “Outbound E-Mail Host,” on page 48 

* Section 3.7.3, “Outbound E-Mail Authentication,” on page 48 

* Section 3.7.4, “Outbound E-Mail Send Restriction,” on page 49 


After installation, outbound e-mail can be disabled and enabled again on the Vibe site, as described 
in “Configuring E-Mail Integration” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 
However, you must configure outbound e-mail in the Vibe installation program. 


Outbound E-Mail Protocol 


E-mail systems communicate by using SMTP (Simple Mail Transfer Protocol). You need to determine 
whether the e-mail system that you want your Vibe site to communicate with is using SMTP or 
SMTPS (secure SMTP). 


For GroupWise, you can check how the Internet Agent is configured: 


1 In ConsoleOne, browse to and right-click the Internet Agent object, then click Properties. 
2 Click GroupWise > Network Address. 
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3.7.2 


3.7.3 


In the SMTP field, if the SSL column displays Disabled, GroupWise is using SMTP. If the SSL 
column displays Enabled, GroupWise is using SMTPS. 


3 Click Cancel to close the Network Address page. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Outbound E-Mail Protocol, mark SMTP or SMTPS to match the e-mail system that you want Vibe 
to communicate with. 


If the e-mail system requires SMTPS, see “Securing E-Mail Transfer” in “Site Security” in the Novell 
Vibe 3.4 Administration Guide. 


Outbound E-Mail Host 


In order to send messages to your e-mail system, Vibe needs to know the hostname of your SMTP 
mail server. 


The default SMTP port of 25 is typically appropriate, unless the SMTP mail server requires port 465 
or 587 for SMTPS connections. 


For GroupWise, this is the hostname of a server where the Internet Agent is running. GroupWise 
always uses port 25, even when SSL is enabled. 


When the Vibe site sends e-mail notifications for scheduled events, the messages are time-stamped 
according to the time zone you specify here during installation. This setting allows you to use a time 
zone for e-mail notifications that is different from the time zone where the server is located. The time 
zone list is grouped first by continent or region, optionally by country or state, and lastly by city. Some 
common selections for United States time zones are: 


Time Zone Continent/City 
Pacific Time America/Los Angeles 
Mountain Time America/Denver 
Central Time America/Chicago 
Eastern Time America/New York 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Outbound E-Mail Host, specify the name of the mail host, the SMTP port number it uses, and the 
time zone for the time stamp you want on scheduled event notifications. 


Outbound E-Mail Authentication 


Many SMTP mail hosts require a valid e-mail address before they establish the SMTP connection. 
Some e-mail systems can construct a valid e-mail address if you specify only a valid username; other 
e-mail systems require that you specify the full e-mail address for successful authentication. You 
should provide a username (e-mail address) to ensure a successful connection. E-mail notifications 
from the Vibe system are sent using this e-mail address in the From field. 


Some e-mail systems also require a password. Some do not. If authentication is required, you should 
also provide a password. 
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3.7.4 


3.8 


3.8.1 


By default, the GroupWise Internet Agent does not require authentication in order to receive inbound 
messages. However, the /forceinboundauth startup switch is available for use in the Internet Agent 
startup file (gwia.cfg) to configure the Internet Agent to refuse SMTP connections where a valid e- 
mail username and password are not provided. The Internet Agent can accept just the username or 
the full e-mail address. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Outbound E-Mail Authentication, indicate whether or not authentication is required for the Vibe 
site to communicate with your e-mail system. If it is, specify the username or e-mail address, and if 
necessary, the password for the e-mail account. 


Outbound E-Mail Send Restriction 


By default, the Vibe site allows Vibe users to send messages to all Vibe users by using the All Users 
group on the Vibe site. On a very large Vibe site, this generates a very large number of e-mail 
messages. If desired, you can prevent messages from being sent to the All Users group. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Allow Sending E-Mail to All Users, mark whether or not you want users to be able to send messages to 
the All Users group. 


Enabling Inbound E-Mail 


You can configure your Novell Vibe site so that users can post comments by e-mailing them to the 
folder where they want to post the comment. In order to receive e-mail postings, folders must be 
properly configured, as described in “Enabling Folders to Receive Entries through E-Mail” in 
“Managing Folders” in the Novell Vibe 3.4 Advanced User Guide. Also, users must know the e-mail 
address of the folder where they want to post their comment. 

* Section 3.8.1, “Internal Mail Host for Inbound E-Mail,” on page 49 

* Section 3.8.2, “Inbound E-Mail Port Number,” on page 50 

¢ Section 3.8.3, “Inbound E-Mail IP Address,” on page 50 

* Section 3.8.4, “Inbound E-Mail Security,” on page 50 
After installation, inbound e-mail can be disabled and enabled again on the Vibe site, as described in 


“Disabling/Enabling Inbound E-Mail Postings” in “Site Setup” in the Novell Vibe 3.4 Administration 
Guide. However, you must configure inbound e-mail in the Vibe installation program. 


Internal Mail Host for Inbound E-Mail 
Inbound e-mail is disabled by default. When you enable it, the Vibe site starts an internal SMTP mail 
host to receive incoming messages and post them to the folders associated with the e-mail 


addresses to which the messages are addressed. By default, the internal SMTP mail host uses port 
2525, so that it does not conflict with another mail host that might be running on the Vibe server. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Inbound E-Mail Configuration, mark whether or not you want users to be able to post to the Vibe site 
from their e-mail clients. 
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3.8.2 


3.8.3 


3.8.4 


Inbound E-Mail Port Number 


Selecting the port number for the Vibe internal SMTP mail host presents the same issue that needs to 
be dealt with for the HTTP port numbers, as described in “HTTP/HTTPS Ports” on page 40. You 
might want to configure the Vibe internal SMTP mail host to use the standard SMTP port of 25. How 
you handle the issue depends on whether you are installing on Linux or on Windows. 


Linux: Keep the default port number (2525) in the Vibe Installation program, then complete the steps in 
Section 4.1.6, “Setting Up Port Forwarding,” on page 66 so that requests incoming on port 25 are 
forwarded to port 2525. 


Windows: Specify port 25 for incoming e-mail in the Vibe Installation program. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Inbound E-Mail Configuration, specify the port number for the Vibe internal SMTP host to listen on. 


Inbound E-Mail IP Address 


If you want to install Vibe on a server where an SMTP mail host is already running, you can do so if 
the server has multiple IP addresses. The existing SMTP mail host can use port 25 on one IP address 
and Vibe can use port 25 on another IP address. During installation, you need to specify an IP 
address only if the server has multiple IP addresses and you want Vibe to bind to a specific IP 
address rather than all of them. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Inbound E-Mail Configuration, specify the IP address for the Vibe internal SMTP host to listen on, if you 
are installing Vibe on a server with multiple IP addresses and you want Vibe to bind to just one of them. 


Inbound E-Mail Security 


You can choose whether the Vibe internal mail host uses TLS (Transport Layer Security) when it 
communicates with other SMTP mail hosts. In order for TLS to function properly, you must have a 
certificate on the Vibe server, as described in “Securing E-Mail Transfer” in “Site Security” in the 
Novell Vibe 3.4 Administration Guide. When an SMTP mail host queries the Vibe mail host, the Vibe 
mail host communicates its ability or inability to handle TLS. The other SMTP mail host then 
communicates appropriately, taking into account how the Vibe internal mail host is configured. The 
default is to use TLS, because this provides more secure communication between mail hosts. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Inbound E-Mail Configuration, mark whether or not you want the Vibe server to announce that it can use 
TLS. 


You can install Vibe with Announce TLS selected, and then set up the certificate afterwards. However, 
if you select Announce TLS, inbound e-mail does not work until the certificate is available on the Vibe 
server. 
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3.9 


3.9.1 


3.9.2 


3.10 


Planning Site Security 


* Section 3.9.1, “Vibe Site Administrator Password,” on page 51 
* Section 3.9.2, “Linux User ID for Vibe,” on page 51 


Vibe Site Administrator Password 


When you first log in to the Novell Vibe site, you use admin as the Vibe administrator username and 
admin as the password. You should immediately change the password to one of your own choosing. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Vibe Administrator Credentials, specify the password that you want to use whenever you log in as 
the Vibe site administrator. 


Linux User ID for Vibe 


For optimum security, Vibe should not run as the Linux root user. For example, if an intruder 
manages to assume the identity of the Vibe program, the intruder gains all the privileges of the 
commandeered process. If the process is running with root user privileges, the intruder has root 
access to your system. If the process is running as a user with minimal privileges, the intruder has 
only restricted access to your system. Therefore, your system is more secure if the Vibe program 
does not run as root. For example, you might want to create a user named vibeadmin for the Vibe 
program to run as. Linux users require a full name and a password. 


In addition to creating a Linux user for the Vibe program to run as, you can also create a Linux group 
for that user to belong to. This enables the Vibe program to create directories and files with consistent 
ownership and permissions. For example, you might want to create a group named vibeadmin for the 
vibeadmin user to belong to. Groups do not require passwords. 


As an alternative to creating a custom Linux username and group for Vibe, you can use the existing 
wwwrun username and the www group. This account is typically used to start Web server processes. 
BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Linux Username and Group, specify the non-root Linux username and group name to use for 
running the Vibe program. If you are creating a new Linux user, specify its full name and password. 


IMPORTANT: The non-root Linux username and group must exist before you start the Vibe 
Installation program. Instructions for creating the username and group are provided in Section 4.1.1, 
“Performing Pre-Installation Tasks on Linux,” on page 61. 


Gathering Directory Services Information 


Unless you are planning a very small Novell Vibe site, the most efficient way to create Vibe users is to 
synchronize initial user information from your network directory service (Novell eDirectory, Microsoft 
Active Directory, or other LDAP directory service) after you have installed the Vibe software. Over 
time, you can continue to synchronize user information from the LDAP directory to your Vibe site. 
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3.10.1 


3.10.2 


IMPORTANT: The following limitations apply when synchronizing user information to Vibe from an 
LDAP directory service: 


+ Vibe performs one-way synchronization from the LDAP directory to your Vibe site. If you change 
user information on the Vibe site, the changes are not synchronized back to your LDAP directory. 


¢ Vibe does not support multi-value attributes. If your LDAP directory contains multi-value 
attributes, Vibe recognizes only the first attribute. For example, if your LDAP directory contains 
multiple e-mail addresses for a given user, only the first e-mail address is synchronized to Vibe. 


¢ Section 3.10.1, “LDAP Directory Service,” on page 52 
* Section 3.10.2, “LDAP Connections,” on page 52 
* Section 3.10.3, “LDAP Synchronization Options,” on page 55 


LDAP Directory Service 


You can synchronize initial Vibe user information from any LDAP directory. This guide provides 
instructions for synchronizing user information from eDirectory and Active Directory. If you are using 
another LDAP directory, use the instructions as guidelines for the tasks you need to perform. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP Directory Service, mark the LDAP directory service from which you want to synchronize 
Vibe user information. 


LDAP Connections 


You can configure one or more LDAP connections. Each connection requires the following 
configuration information: 


* “LDAP Server” on page 52 
* “LDAP Attribute to Identify a User or Group” on page 53 
* “LDAP Attribute for Vibe Name” on page 54 


+ “User and Group Object Locations” on page 54 


LDAP Server 


In order to synchronize initial user information, Vibe needs to access an LDAP server where your 
directory service is running. You need to provide the hostname of the server, using a URL with the 
following format: 


ldap://hostname 


If the LDAP server requires a secure SSL connection, use the following format: 


ldaps://hostname 


If the LDAP server is configured with a default port number (389 for non-secure connections or 636 
for secure SSL connections), you do not need to include the port number in the URL. If the LDAP 
server uses a different port number, use the following format for the LDAP URL: 


ldap://hostname:port_ number 
ldaps://hostname:port_number 
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IMPORTANT: When modifying an existing LDAP connection, do not modify the LDAP server URL. 
Doing so can lead to synchronized users being disabled or deleted. 


In addition, Vibe needs the username and password of a user on the LDAP server who has sufficient 
rights to access the user information stored there. You need to provide the username, along with its 
context in your LDAP directory tree, in the format expected by your directory service. 


Directory Service Format for the Username 
eDirectory cn=username, ou=organizational_unit,o=organization 
Active Directory cn=username, ou=organizational unit,dc=domain component 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP Server URL, specify the LDAP URL of the server, a fully qualified username with sufficient 
rights to read the user information, and the password for that user. 


If the LDAP server requires a secure SSL connection, additional setup is required. You must 
complete the steps in “Securing LDAP Synchronization” in “Site Security” in the Novell Vibe 3.4 
Administration Guide to import the root certificate for your LDAP directory into the Java keystore on 
the Vibe server before you configure Vibe for LDAP synchronization. 


LDAP Attribute to Identify a User or Group 


The LDAP attribute that uniquely identifies a user or group helps facilitate renaming and moving Vibe 
users and groups in the LDAP directory. If this attribute is not set, and you rename or move a user in 
the LDAP directory, Vibe assumes that the new name (or the new location of the same name) 
represents a new user, not a modified user, and creates a new Vibe user. 


For example, suppose you have a Vibe user with a given name of William Jones. If William changes 
his name to Bill, and you make that change in the LDAP directory, Vibe creates a new user named Bill 
Jones. 


To ensure that Vibe modifies the existing user instead of creating a new user when the user is 
renamed or moved in the LDAP directory, you must specify the name of the LDAP attribute that 
uniquely identifies the user. For eDirectory, this value is GuID. For Active Directory, this value is 
objectGUID. This attribute always has a unique value that does not change when you rename or 
move a user in the LDAP directory. If you want to map users to a different attribute, you must ensure 
that the attribute that you use is a binary attribute. For example, the cn attribute cannot be used 
because it is not a binary attribute. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP that uniquely identifies a user or group, mark GUID or obj ect GUID, depending on whether 
your LDAP directory is eDirectory or Active Directory. 
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LDAP Attribute for Vibe Name 


The setting LDAP Attribute Used for Vibe Name is used for two purposes: 


* The value is used as the Vibe username when the user is first provisioned from LDAP. The value 
of this attribute must be unique. 


¢ During Vibe login, Vibe uses this attribute to locate the user in the LDAP directory, then tries to 
authenticate as that user. 


LDAP directories differ in the LDAP attribute used to identify a User object. Both eDirectory and 
Active Directory might use the cn (common name) attribute. A more sure alternative for Active 
Directory is to use the sAMAccountName attribute. Other LDAP directories might use the uid (unique 
ID) attribute, depending on the structure and configuration of the directory tree. 


You might need to consult with your directory administrator in order to determine which attribute is 
best to use. 


As needed, other LDAP attributes can be used, as long as the attribute is unique for each User 
object. For example, the mail LDAP attribute on User objects could be used to enable Vibe users to 
log in to the Vibe site by using their e-mail addresses. 


NOTE: Because the login name becomes part of the user’s workspace URL, the at sign (@) in the e- 
mail address is replaced with an underscore (_) in the workspace URL because @ is not a valid 
character in a URL. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP attribute used for Vibe name, mark the attribute that you are going to use (for example, cn, 
sAMAccountName, or uid), based on the convention used by your LDAP directory service for User 
objects. Ensure that users have a value for the attribute that you mark. 


User and Group Object Locations 


Vibe can find and synchronize initial user information from User objects located in one or more 
containers in the LDAP directory tree. A container under which User objects are located is called a 
base DN (distinguished name). The format you use to specify a base DN depends on your directory 
service. 


Directory Service Format for the User Container 
eDirectory ou=organizational unit ,o=organization 
Active Directory ou=organizational unit,dc=domain component 


To identify potential Vibe users, Vibe by default filters on the following LDAP directory object 
attributes: 

* Person 

* orgPerson 


* inetOrgPerson 


Novell Vibe 3.4 Installation Guide 


If you want to create Vibe groups based on information in your LDAP directory, Vibe filters on the 
following LDAP directory object attributes: 

* group 

* groupOfNames 

* groupOfUniqueNames 
You can add attributes to the user or group filter list if necessary. You can use the following operators 
in the filter: 

+ | OR (the default) 

* & AND 

+ ! NOT 


You can choose whether you want Vibe to search for users (and optionally, groups) in containers 
underneath the base DN (that is, in subtrees). 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP User Context, specify a base DN, along with object attributes if any, and mark whether you 
want subtrees searched for Vibe users. 


Under LDAP Group Context, specify a base DN, along with object attributes if any, and mark whether you 


want subtrees searched for Vibe groups. 


You might find it convenient to create a group that consists of all the users that you want to set up in 
Vibe, regardless of where they are located in your LDAP directory. After you create the group, you 
can use the following filter to search for User objects that have the specified group membership 
attribute: 


(groupMembership=cn=group name, ou=organizational_unit,o=organization) 


IMPORTANT: Be sure to include the parentheses in your filter. 


3.10.3 LDAP Synchronization Options 


The following synchronization options apply to all LDAP configurations within the same Vibe zone: 


¢ “Synchronization Schedule” on page 56 
* “User Synchronization Options” on page 56 


* “Group Synchronization Options” on page 57 


NOTE: Because the synchronization options apply to all LDAP configurations within the same zone, 
you cannot have customized synchronization settings for each LDAP configuration. However, the 
Novell Vibe site can have multiple zones. For more information about zones, see “Setting Up Zones 
(Virtual Vibe Sites)” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 
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Synchronization Schedule 


When you enable LDAP synchronization, you can set up a schedule for when it is convenient for 
synchronization to occur. In planning the schedule, take into account how often your LDAP directory 
user (and, optionally, group) information changes and the server resources required to perform the 
synchronization for the number of users (and, optionally, groups) that you have. 


You can choose to have LDAP synchronization performed every day, or you can select specific days 
of the week when you want it performed (for example, on Monday, Wednesday, and Friday). You can 
choose to have it performed once a day at a specified time (for example, at 2:00 a.m.), or you can set 
a time interval, so that it is performed multiple times each day (for example, every four hours). The 
smallest time interval you can set is .25 hours (every 15 minutes). 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Synchronization Schedule, record the schedule for when you want LDAP synchronization to take 
place. 


User Synchronization Options 


The following options are available for enabling and configuring user synchronization from your LDAP 
directory to your Vibe site: 


¢ Synchronize User Profiles: Select this option to synchronize user information whenever the 
LDAP directory information changes after initial Vibe site setup. The attributes that are 
synchronized are the attributes that are found in the map box in the Users section on the 
Configure LDAP Synchronization page. 


Users 


LDAP attribute used for Vibe name: uid 


In the box below, map the internal identifiers to the LDAP attribute names of the user record. Use 
the following syntax: internallD=IdapAttName 

firstName=gn 

emailAddress=mail 

lastName=sn 

IdapGuid=cn 

description=description 

phone=telephoneNumber 

lastName=surname 

firstName=givenName 


By default, Vibe synchronizes the following attributes from the LDAP directory: 

* First name 

* Last name 

* Phone number 

* E-mail address 

* Description 
For information about how to add additional attributes to be automatically synchronized, see 
“Synchronizing Additional LDAP Attributes” in the Novell Vibe 3.4 Administration Guide. 


* Register LDAP User Profiles Automatically: Select this option to automatically add LDAP 
users to the Vibe site. However, workspaces are not created until users log in to the Vibe site for 
the first time. 


56 Novell Vibe 3.4 Installation Guide 


* Disable users that have been provisioned from LDAP and are no longer in LDAP: Select 
this option to disable users that were previously provisioned to the Vibe site from LDAP, but who 
no longer exist in the LDAP directory. 


* Delete users that have been provisioned from LDAP and are no longer in LDAP: Select 
this option to delete users that were previously provisioned to the Vibe site from LDAP, but who 
no longer exist in the LDAP directory. 


IMPORTANT: A deleted user cannot be undeleted; deleting a user is permanent and is not 
reversible. 


Novell recommends that you disable users rather than delete them. 


For more information about disabled users in Vibe, see “Disabling Vibe User Accounts” in the 
Novell Vibe 3.4 Administration Guide. 


This option is designed to use only when you have deleted users from your LDAP directory and 
you want the LDAP synchronization process to delete those same users from Vibe. 


* When Deleting Users, Delete Associated User Workspaces and Content: Select this option 
to remove obsolete information along with the user accounts. 


* Time Zone for New Users Select this option to set the time zone for user accounts that are 
synchronized from the LDAP directory into your Vibe site. The time zone list is grouped first by 
continent or region, optionally by country or state, and lastly by city. Some common selections for 
United States time zones are: 


Time Zone Continent/City 
Pacific Time America/Los Angeles 
Mountain Time America/Denver 
Central Time America/Chicago 
Eastern Time America/New York 


* Locale for New Users: Select this option to set the locale for user accounts that are 
synchronized from the LDAP directory into your Vibe site. The locale list is sorted alphabetically 
by language. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP User Options, mark the synchronization options you want to use. 


Group Synchronization Options 


The following options are available for enabling and configuring user and group synchronization from 
your LDAP directory to your Vibe site: 


¢ Synchronize Group Profiles: Select this option to synchronize group information, such as the 
group description, to the Vibe site whenever this information changes in LDAP. 


* Register LDAP Group Profiles Automatically: Select this option to automatically add LDAP 
groups to the Vibe site. 


¢ Synchronize Group Membership: Select this option so that the Vibe group includes the same 
users (and possibly groups) as the group in your LDAP directory. If you do not select this option, 
and you make changes to group membership in the LDAP directory, the changes are not 
reflected on your Vibe site. 
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+ 


Delete Local Groups That Are Not in LDAP: Select this option to delete groups that exist on 
the Vibe site but do not exist in your LDAP directory. Use this option under the following 
conditions: 


+ You have deleted groups from your LDAP directory and you want the LDAP synchronization 
process to delete them from Vibe as well. 


¢ In addition to the groups synchronized from LDAP, you create some Vibe groups manually, 
as described in “Creating Groups of Users” in “Site Setup” in the Novell Vibe 3.4 
Administration Guide, and you want the LDAP synchronization process to delete the 
manually created groups. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under LDAP Group Options, mark the synchronization options you want to use. 


3.11 Accommodating Multiple Languages 


The Novell Vibe installation program runs in English only. When you install the Vibe software, you can 
choose to have the primary language of the Vibe site to be any of the following languages: 
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+ 


+ 


+ 


+ 


Chinese-Simplified 
Chinese Traditional 
Danish 

Dutch 

English 

French 

German 
Hungarian 

Italian 

Japanese 

Polish 

Portuguese 
Russian 

Spanish 

Swedish 


Some languages have an additional distinction by locale (the country where the language is spoken). 


The language you select during installation establishes the language of the global text that displays in 
locations where all Vibe users see it, such as in the Workspace tree when you click the Workspace 
tree icon &: 


© 


Home Workspace Personal Workspace Guest (guest) 


The language you select also establishes the default interface language and locale for creating new 
workspaces. 
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BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Default Locale, mark the default language and specify the default country for your Vibe site. 


Additional language customization can be done after installation, as described in “Managing a 
Multiple-Language Vibe Site” in “Site Setup” in the Novell Vibe 3.4 Administration Guide. 
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Installing and Setting Up a Basic Vibe 
Site 


Follow the setup instructions for the platform where you are installing Novell Vibe: 


+ 


+ 


Section 4.1, “Linux: Installing and Setting Up a Basic Vibe Site,” on page 61 
Section 4.2, “Windows: Installing and Setting Up a Basic Vibe Site,” on page 70 


4.1 Linux: installing and Setting Up a Basic Vibe Site 


You should already have reviewed Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and 
filled out the Basic Vibe Installation Summary Sheet. The following sections step you through the 
process of installing and starting Novell Vibe on Linux. 


+ 


+ 


+ 


Section 4.1.1, “Performing Pre-Installation Tasks on Linux,” on page 61 
Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63 
Section 4.1.3, “Installing Missing Libraries,” on page 66 

Section 4.1.4, “Checking for Available Hot Patches,” on page 66 

Section 4.1.5, “Configuring Vibe to Start Automatically on Reboot,” on page 66 
Section 4.1.6, “Setting Up Port Forwarding,” on page 66 

Section 4.1.7, “Starting Vibe on Linux,” on page 68 

Section 4.1.8, “Checking the Status of the Vibe Server,” on page 69 
Section 4.1.9, “Restarting Vibe,” on page 69 

Section 4.1.10, “Stopping Vibe,” on page 69 

Section 4.1.11, “Uninstalling Vibe,” on page 69 


4.1.1 Performing Pre-Installation Tasks on Linux 


1 Make sure that the Linux server where you plan to install Vibe meets the system requirements 


listed in Section 2.2, “Vibe 3.4 Server Requirements,” on page 20. 


2 Ina terminal window, become root by entering su - and the root password. 


3 Set the Linux open file limit to meet the needs of the Vibe software: 


3a Open the /etc/security/limits.conf file in an ASCII text editor. 
3b Add the following lines to the bottom of the list, following the format of the example lines: 


* hard nofile 65535 
* soft nofile 4096 


3c Save the file, then exit the text editor. 


4 Perform the following conditional tasks if necessary: 


+ “Stopping and Disabling an Existing Web Server” on page 62 
+ “Creating a Vibe User and Group” on page 62 
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Stopping and Disabling an Existing Web Server 


If a Web server is currently running on the Vibe server, stop it, and preferably disable it. 
For example, to stop the Apache Web server and its associated instance of Tomcat: 
1 Enter the following commands to stop Apache and Tomcat: 


/etc/init.d/tomcat5 stop 
/etc/init.d/apache2 stop 


2 Enter the following commands to make sure that Apache and Tomcat do not start again when 
you reboot the server: 


chkconfig --del apache2 
chkconfig --del tomcat5 


Creating a Vibe User and Group 


If the user and group that you want to use for Vibe, as described in Section 3.9.2, “Linux User ID for 
Vibe,” on page 51 do not exist yet, create them. It is easier if you create the group first. 
1 Create the Linux group that you want to own the Vibe software and data store directories: 


1a In YaST, click Security and Users > User and Group Management to display the User and 
Group Administration page. 


1b Click Groups, then click Add. 
1c Specify the group name, then click Accept or OK. 
The group does not need a password. 
2 Create the Linux user that you want Vibe to run as: 
2a Click Users, then click Add. 


2b On the User Data tab, specify the user's full name, username, and password, then select 
Disable User Login. 


Like any Linux system user, the Vibe Linux user does not need to manually log in. The Vibe 
Linux user does not need a password, either, but YaST requires you to provide one. 


2c Click the Details tab. 


2d In the Login Shell drop-down list, select /bin/false, because this user does not need to 
manually log in. 


2e In the Default Group drop-down list, select the Linux group that you created in Step 1. 
2f In the Groups list, select the Linux group that you created in Step 1. 
2g Click Accept or OK. 

3 Exit YaST. 
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4.1.2 


Running the Linux Vibe Installation Program 


When you run the Vibe installation program for the first time, you typically want to use the GUI 
interface. However, if you are installing Vibe on a server where the X Window System is not available, 
a text-based installation program is also available. After you are familiar with the Vibe installation 
process, you can use a silent installation to automate the process. 

* “Using the GUI Installation Program” on page 63 

* “Using the Text-Based Installation Program” on page 64 


* “Performing a Silent Installation” on page 65 


Using the GUI Installation Program 


1 Ina terminal window, enter su - to become the root user, then enter the root password. 


You need root permissions in order to install the Vibe software, but you should not run the Vibe 
software as root. 


2 Change to the directory where you downloaded and extracted the Vibe software. 


3 Make sure that you have a license-key.xml file in the same directory with the Vibe installation 
program. 


more license-key.xml 


The Vibe installation program does not start without a license file in the same directory. If you 
have not already, rename the license file to be called license-key.xml. 


For more information about licensing, see Chapter 6, “Updating Your Vibe License,” on page 83. 
4 Enter the following command to start the Vibe installation program: 
./installer-teaming.linux 


5 Accept the License Agreement, then click Next. 
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Installation Options 


Select the action you want to perform. 


© New installation 
© Update software and settings 
© Reconfigure settings 


6 Click Next to accept the default of New installation. 
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Choose Installation Type 


Select the type of installation you want to perform 


Select the Basic installation if you do not want to configure 


Advanced any of the optional features. 


7 Click Next to accept the default of Basic. 
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8 Use the information that you have gathered on the Basic Vibe Installation Summary Sheet to 
provide the information that the Vibe installation program prompts you for: 


Installation Locations 
Location of TrueType Fonts for Stellent Converters 
Default Locale for Novell Vibe 
User ID for Novell Vibe 
Network Information 
WebDAV Authentication Method 
Database Selection 
Database Type 
JDBC URL 
Credentials 
Setup 
Encryption Algorithm 
Java JDK Location 
Outbound E-Mail Configuration 
Protocol 
Host, Port, and Time Zone 
Username, Password, and Authentication 
Allow Sending E-Mail to All Users 
Inbound E-Mail Configuration 


The installation program stores the information it gathers in the installer.xml file in the same 
directory where you started the installation program. 


9 After you have provided all the requested information, click Install to begin the Vibe installation. 
10 When the installation is completed, click Finish to exit the Vibe installation program. 


Information about the installation process is written to the installer. log file in the same 
directory where you ran the Installation program. If a problem arises during the installation, the 
installer.log file provides information that can help you resolve the problem. 


11 Continue with Section 4.1.5, “Configuring Vibe to Start Automatically on Reboot,” on page 66. 


Using the Text-Based Installation Program 


If you try to start the GUI Vibe installation program in an environment where the X Windows System is 
not running, the text-based Vibe Installation program starts. 
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Checking license key... 
License Summary 


Product: Novell Vibe 


Version: 3.0 

UID: 1 
Effective: 10/27/2012 
Expires: never 
Users: unlimited 


Installing this software requires agreement to the 
terms and conditions set forth in the: 
Novell EULA and Export Compliance Notice 


You can review this agreement again at the download site or 
type "REVIEW" below. 


Note: You must answer "YES" to install the software. 


Have you read and agree with the license? : 


If you want to use the text-based installation program in an environment where the GUI starts by 
default, use the following command in the directory where the installation program is located: 


./installer-teaming.linux --text 


IMPORTANT: The text-based Vibe installation program must be run in the same directory where the 
Vibe license file is located. If the license file is not in the same directory, the text-based installation 
program cannot find it. 


The text-based installation program gathers the same configuration information as the GUI 
installation program does. This information is stored in the installer.xml file in the directory where 
you run the installation program. 


The installation program does not write the information it gathers into the installer .xml file until you 
exit the installation program, and you cannot go back when you use the text-based installation 
program. Therefore, when you use the text-based installation program, you should plan your 
installation carefully in advance, using the Basic Vibe Installation Summary Sheet or the Advanced 
Vibe Installation Summary Sheet. If you make a mistake during the installation, continue to the end of 
the installation process and exit the installation program normally, so that all information is saved. 
Then run the text-based installation program again. Your previous information is supplied as defaults 
and you can change the information as needed. 


Performing a Silent Installation 


If your Vibe system expands beyond one server, you might need to repeatedly install the same Vibe 
components. A silent installation makes this an easy process. Edit an existing installer.xm1 file so 
that it has the hostname of the server where you want to perform the silent installation and copy it to 
that server. In the directory where the installation program is located, use the appropriate command 
to run the Vibe installation program, depending on the action that you want the silent installation to 
perform: 


./installer-teaming.linux --silent --install 
./installer-teaming.linux --silent --upgrade 
./installer-teaming.linux --silent --reconfigure 


The Installation program obtains all the information it needs from the installer.xml file and 
completes the installation without user interaction. If you have manually modified index server scripts, 
such as the indexserver-startup. sh file as described in Section 14.1, “Installing the Lucene 
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4.1.4 


4.1.5 


4.1.6 


Software,” on page 135, all modifications will be lost when you perform a silent upgrade. To retain 
your modifications, you should upgrade with the GUI installation program, as described in “Using the 
GUI Installation Program” on page 63. 


Installing Missing Libraries 


After you install Vibe on SLES, you should check for and install any missing libraries. 
1 Change to the following directory: 
/opt/novell/teaming/stellent-converter/linux/x86 


2 Run the exporter program. 

The errors about missing input and output files are expected, and you can safely ignore them. 
3 Look for errors about missing libraries. 
4 If there are library errors, install any libraries that are missing. 

On 64-bit Linux systems, a common missing library is libstdc++. 


You can use the following command to install the missing libraries: 


zypper in library file 


Checking for Available Hot Patches 


After you install Vibe, make sure that you check on the Vibe download site where you downloaded the 
Vibe software for any hot patches that might be available. 


Configuring Vibe to Start Automatically on Reboot 


You can configure Vibe to start automatically each time you reboot the Linux server. 
1 As the Linux root user, enter the following command: 


chkconfig --add teaming 


2 To verify that automatic startup is turned on, enter the following command: 


chkconfig teaming 


Setting Up Port Forwarding 


In order to make Vibe available on the default HTTP/HTTPS ports of 80 and 443, you must set up port 
forwarding in order to forward the browser default ports (80 and 443) to the Vibe server ports (8080 
and 8443). In addition, you must set up port forwarding if you want to forward the default SMTP mail 
host port (25) to the default Vibe internal mail host port (2525). 


You can set up port forwarding in one of two ways, depending on whether or not you are using the 
Vibe server as a firewall. 


* “Using the SuSEfirewall2 File” on page 67 


* “Using iptables Commands” on page 67 
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Using the SuSEfirewall2 File 


To enable port forwarding on a SUSE Linux server that uses SuSEfirewa112: 


1 As the Linux root user, open the following file: 
/etc/sysconfig/SuSEfirewal12 

2 Findthe following line: 
FW_REDIRECT="" 

3 Between the quotation marks, copy and insert the following string: 


0/0,ip address,tcp,80,8080 0/0,ip address,tcp,443,8443 
0/0,ip address,tcp,25,2525 


4 Replace ip address with the IP address of the Vibe server. 

5 Save the SuSEfirewa112 file, then exit the text editor. 

6 Use the following command to restart the firewall: 
/sbin/SuSEfirewall2 start 


7 Use the following command to verify that the default browser ports (80 and 443) have been 
forwarded to the Vibe server ports (8080 and 8443) and that the default SMTP mail host port (25) 
has been forwarded to the Vibe internal mail host: 


iptables-save | grep REDIRECT 


Now, users do not need to include a port number in the Vibe site URL. 


Using iptables Commands 
To use iptables commands to enable port forwarding on any type of Linux server: 


1 As the Linux root user, change to the /etc/init.d directory. 

2 Ina text editor, create a new file for a set of iptables commands, for example: 
gedit vibe-iptables 

3 Copy and paste the following lines into the vibe-iptables file: 
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iptables -t nat -A OUTPUT -d localhost -p tcp --dport 80 
-j REDIRECT --to-ports 8080 


iptables -t nat -A OUTPUT -d hostname -p tcp --dport 80 
-j REDIRECT --to-ports 8080 


iptables -t nat -A PREROUTING -d hostname -p tcp --dport 80 
-j REDIRECT --to-ports 8080 


iptables -t nat -A OUTPUT -d localhost -p tcp --dport 443 
-j REDIRECT --to-ports 8443 


iptables -t nat -A OUTPUT -d hostname -p tcp --dport 443 
-j REDIRECT --to-ports 8443 


iptables -t nat -A PREROUTING -d hostname -p tcp --dport 443 
-j REDIRECT --to-ports 8443 


iptables -t nat -A OUTPUT -d localhost -p tcp --dport 25 
-j REDIRECT --to-ports 2525 


iptables -t nat -A OUTPUT -d hostname -p tcp --dport 25 
-j REDIRECT --to-ports 2525 


iptables -t nat -A PREROUTING -d hostname -p tcp --dport 25 
-j REDIRECT --to-ports 2525 


In this example, the lines are wrapped for readability. When you paste them into the text editor, if 
the lines are still wrapped, remove the hard returns so that you have six iptables commands, 
each on its own line. 


4 Replace hostname with the hostname or IP address of the Vibe server. 
5 Save the vibe-iptables file, then exit the text editor. 
6 Use the following command to make the file executable: 


chmod +x vibe-iptables 

Use the following command to immediately execute the commands in the vibe-iptables file: 
chkconfig vibe-iptables on 

Use the following command to add vibe-iptables to future server boot initialization: 
chkconfig --add vibe-iptables 


Use the following command to verify that the default browser ports (80 and 443) have been 
forwarded to the Vibe server ports (8080 and 8443) and that the default SMTP mail host port (25) 
has been forwarded to the Vibe internal mail host: 


iptables-save | grep REDIRECT 


Now, users do not need to include a port number in the Vibe site URL. 


Starting Vibe on Linux 


The Vibe Installation program created a teaming startup script in the /etc/init.d directory. 


1 In a terminal window, become root by entering su - and the root password. 


2 Enter the following command to start Vibe: 


/etc/init.d/teaming start 


You must execute the teaming script as root, but the script runs Vibe as the user you selected 
in Section 3.9.2, “Linux User ID for Vibe,” on page 51 and specified during installation. 


You should see output similar to the following example: 
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Using CATALINA BASE: /opt/teaming/apache-tomcat 
Using CATALINA HOME: /opt/teaming/apache-tomcat 
Using CATALINA TEMPDIR: /opt/teaming/apache-tomcat/temp 
Using JRE_HOME: /use/java/jdk1.6.0_02/jre 


3 To make sure that Vibe is ready for work: 
3a Change to the following directory: 
/opt/novell/teaming/apache-tomcat/logs 
3b Enter the following command to display the end of the Tomcat log: 
tail --f catalina.out 


At the end of the log file listing, you should see: 


INFO: Server startup in nnnn ms 


4 Press Ctrl+C when you finish viewing the catalina.out file. 


Checking the Status of the Vibe Server 


You can see if Vibe is running by checking for its process ID (PID). 


1 In a terminal window, enter the following command: 
ps -eaf | grep teaming 


You should see the Vibe PID number, along with a listing of configuration settings. 


Restarting Vibe 


You need to restart Vibe whenever you use the Vibe installation program to make configuration 
changes, as described in Chapter 10, “Performing an Advanced Vibe Installation,” on page 119. 


1 As root in a terminal window, enter the following command: 
/etc/init.d/teaming restart 


You should see the same output as when you originally started Vibe. 


Stopping Vibe 


1 As root in a terminal window, enter the following command: 
/etc/init.d/teaming stop 
You should see the same output as when you started Vibe. 
2 To verify that Vibe has stopped, check for its PID number: 
ps -eaf | grep teaming 


The Vibe PID number, along with a listing of configuration settings, should no longer be 
displayed. 


Uninstalling Vibe 


If you move the Vibe site to a different server, you can delete the Vibe files from the original server to 
reclaim disk space. The default Vibe file locations are: 


Vibe Software /opt/novell/teaming 
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Vibe File Repository and /var/opt/novell/teaming 
Lucene Index 


MySQL Database /var/lib/mysql 


For a complete list of your Vibe files, check the installer .xml file in the directory where you 
originally ran the Vibe installation program. 


Windows: Installing and Setting Up a Basic Vibe 
Site 
You should already have reviewed Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and 
filled out the Basic Vibe Installation Summary Sheet. The following sections step you through the 
process of installing and starting Novell Vibe on Windows. 

* Section 4.2.1, “Performing Pre-Installation Tasks on Windows,” on page 70 

¢ Section 4.2.2, “Running the Windows Vibe Installation Program,” on page 71 

* Section 4.2.3, “Checking for Available Hot Patches,” on page 72 

¢ Section 4.2.4, “Running Vibe as a Windows Service,” on page 73 

¢ Section 4.2.5, “Running Vibe as a Windows Application,” on page 74 

* Section 4.2.6, “Uninstalling Vibe,” on page 74 


Performing Pre-Installation Tasks on Windows 


+ “Verifying System Requirements” on page 70 
¢ “Stopping an Existing Web Server” on page 70 


* “Setting Environment Variables” on page 71 


Verifying System Requirements 


Make sure that the Windows server where you plan to install Vibe meets the system requirements 
listed in Section 2.2, “Vibe 3.4 Server Requirements,” on page 20. 


Stopping an Existing Web Server 


If a Web server is currently running on the Vibe server, stop it, and preferably disable it. 
For example, to stop and disable the Internet Information Services (IIS) Web server: 

1 On the Windows desktop, click Start > Administrative Tools > Services. 

2 Right-click World Wide Web Publishing Service, then click Properties. 


3 In the Startup type drop-down list, select Disabled. 
4 Click Stop, then click OK. 
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Setting Environment Variables 


Make sure that the JAVA_HOME environment variable is set to the path where you installed the JDK 
and that the Windows PATH environment variable includes the path to your database server. 
1 Right-click My Computer, then click Properties. 
2 On the Advanced tab, click Environment Variables. 
3 Set the JAVA_HOME environment variable: 
3a In the System variables box, click New. 
3b In the Variable name field, specify JAVA_HOME. 
3c In the Variable value field, specify the path where you installed the JDK. 


3d Click OK to add the JAVA_HOME environment variable to the list of system variables, then 
click OK again to save the setting and return to the Advanced tab. 


4 Check the PATH environment variable: 
4a On the Advanced tab, click Environment Variables. 
4b In the System variables list, locate the PATH environment variable. 
4c If the path includes your database server software directory, click Cancel. 
or 


If the path does not include your database server software directory, add the directory, then 
click OK. 


4.2.2 Running the Windows Vibe Installation Program 


1 Log in to the Windows server as a user with Administrator rights. 


2 In Windows Explorer, browse to the directory where you downloaded and extracted the Vibe 
software. 


3 Make sure that there is a license-key.xm1 file in the directory. 


The Vibe installation program does not start without a license file, and it has a different name 
when you download it. 


For more information about licensing, see Chapter 6, “Updating Your Vibe License,” on page 83. 
4 Double-click the installer-teaming. exe file to start the Vibe installation program. 


5 Accept the License Agreement, then click Next. 


Novell Vibe 3 Installation Program x| 


Installation Options 


Select the action you want to perform. 


(© New installation 
C Update software and settings 


C Reconfigure settings 


6 Click Next to accept the default of New installation. 
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Choose Installation Type 


Select the type of installation you want to perform N 


Advanced 


7 Click Next to accept the default of Basic. 


8 Use the information that you have gathered on the Basic Vibe Installation Summary Sheet to 
provide the information that the Vibe installation program prompts you for: 


Select the Basic installation if you do not want to configure any of the 
optional features. 


Installation Locations 
Default Locale for Novell Vibe 
Network Information 
WebDAV Authentication Method 
Database Selection 
Database Type 
JDBC URL 
Credentials 
Setup 
Encryption Algorithm 
Java JDK Location 
Outbound E-Mail Configuration 
Protocol 
Host, Port, and Time Zone 
Username, Password, and Authentication 
Allow Sending E-Mail to All Users 
Inbound E-Mail Configuration 


The installation program stores the information it gathers in the installer .xm1 file in the same 
directory where you started the installation program. 


9 After you have provided all the requested information, click Install to begin the Vibe installation. 
10 When the installation is completed, click Finish to exit the Vibe installation program. 


Information about the installation process is written to the installer. log file in the same 
directory where you ran the Installation program. If a problem arises during the installation, the 
installer.log file provides information that can help you resolve the problem. 


11 Continue with one of the following sections, depending on how you want to run the Vibe 
software: 


* Section 4.2.4, “Running Vibe as a Windows Service,” on page 73 


* Section 4.2.5, “Running Vibe as a Windows Application,” on page 74 


4.2.3 Checking for Available Hot Patches 


After you install Vibe, make sure that you check on the Vibe download site where you downloaded the 
Vibe software for any hot patches that might be available. 
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Running Vibe as a Windows Service 


* “Configuring Vibe as a Windows Service” on page 73 

¢ “Starting Vibe as a Windows Service” on page 73 

+ “Configuring the Vibe Service to Start Automatically on Reboot” on page 73 
* “Restarting the Vibe Service” on page 73 


* “Stopping the Vibe Service” on page 74 


Configuring Vibe as a Windows Service 


The Vibe installation program created a service.bat file for configuring Vibe to run as a Windows 
service. 
1 In a Command Prompt window, change to the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat \bin\windows 
2 Inthe windows directory, copy the files from the appropriate subdirectory. 
The following subdirectories exist: x86, x64, ia64. 
If you are unsure which subdirectory is appropriate for your server, use the readme.txt file 


located in the c:\Program Files\Novell\Teaming\apache-tomcat \bin\windows directory as 


a reference. 
3 Paste the files into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory. 
4 Use the following command to configure Vibe as a Windows service: 

service.bat install Teaming 


This creates a service named Apache Tomcat Teaming. 


Starting Vibe as a Windows Service 


1 On the Windows desktop, click Start > Administrative Tools > Services. 


2 Right-click Apache Tomcat Teaming, then click Start. 


Configuring the Vibe Service to Start Automatically on Reboot 


When you run Vibe as a Windows service, you can configure Vibe to start automatically each time 
you reboot the Windows server. 


1 On the Windows desktop, click Start > Administrative Tools > Services. 
2 Right-click Apache Tomcat Teaming, then click Properties. 
3 In the Startup type drop-down list, select Automatic, then click OK. 


Restarting the Vibe Service 


You need to restart Vibe whenever you use the Vibe installation program to make configuration 
changes, as described in Chapter 10, “Performing an Advanced Vibe Installation,” on page 119. 


1 On the Windows desktop, click Start > Administrative Tools > Services. 
2 Right-click Apache Tomcat Teaming, then click Restart. 
3 Close the Services window. 
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Stopping the Vibe Service 


1 On the Windows desktop, click Start > Administrative Tools > Services. 
2 Right-click Apache Tomcat Teaming, then click Stop. 
3 Close the Services window. 


Running Vibe as a Windows Application 


¢ “Starting Vibe as an Application” on page 74 
¢ “Stopping Vibe as an Application” on page 74 


Starting Vibe as an Application 
The Vibe installation program created a startup .bat file for starting Vibe. 


1 In a Command Prompt window, change to the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat\bin 


2 Run the startup.bat file to start Vibe as an application. 


Stopping Vibe as an Application 


1 In a Command Prompt window, change to the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat\bin 


2 Run the shutdown.bat file to stop the Vibe application. 


Uninstalling Vibe 


If you move the Vibe site to a different server, you can delete the Vibe files from the original server to 
reclaim disk space. The default Vibe file locations are: 
Vibe Software c:\Program Files\Novell\Teaming 


Vibe File Repository and c:\Novell\Teaming 
Lucene Index 


MS SQL Database c:\Program Files\Microsoft SQL Server\MSSQL\Data 


For a complete list of your Vibe files, check the installer .xml file in the directory where you 
originally ran the Vibe Installation program. 
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Adding Users to Your Vibe Site 


After you have installed Novell Vibe and made sure that Vibe starts successfully, you are ready to 
access your Vibe site from your Web browser and add users. 


* Section 5.1, “Accessing Your Basic Vibe Site as the Site Administrator,” on page 75 
* Section 5.2, “Creating a User,” on page 77 
* Section 5.3, “Adding Vibe Users from Your LDAP Directory,” on page 78 


Accessing Your Basic Vibe Site as the Site 
Administrator 


1 In your Web browser, specify one of the following URLs, depending on whether or not you are 
using a secure SSL connection: 


http://vibe_server 
https://vibe_server 


Replace vibe_server with the DNS hostname or fully qualified domain name of the Novell Vibe 


server. If you have configured the HTTP ports correctly, you do not need to include the port 
number in the Vibe URL. 


Novell. Vibe 


User ID 


Password: 


2 Log in using admin as the login name and admin as the password. 
3 Click My Workspace in the Action toolbar. 


The Vibe administrator’s personal workspace is displayed. 
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Novell admin | Log Out | WE 


+), is (O MyWorkspace © Whats New MyFavorites * MyTeams % RecentPlaces » Workspace ® View % u G 
admin (admin) A 
admin (admin) prot 
® Blog iù È È 
ES) Calendar What are you working on 
LU Files 
Ba Guestbook 
[iPhoto Abu nmm Accessories 
ila Accessory Panelw <7 
mj Trash z 
Task Name Priority Due Date Status Assigned to % Done Location 
admin (admin) // Guestbook Sign the guestbook 
Biog 0000- 
admin (admin) // Blog 
No results 
Photo Album 0000907 
admin (admin) // Photo Album 
Permalinks 
admin | LogOut | WE 
+) hy uk. ()MyWorkspace <)What'sNew My Favorites ™ MyTeams ™ RecentPlaces ™ Workspace ™ View ™ a (et 
bici n admin (admin) Profile 
® Blog 
E Calendar What are you working on? 
UU Files 
BA Guestbook = 
[E] Fhoto Album D eee ee CEEE Accessories 
Tasks Z na 2A 
= ] 
E Trash = cessory ns av 
Tasks +1360o 
[No Entries] 
Task Name Priority Due Date Status Assigned to % Done Location 
Guestbook tighe 
admin (admin) / Guestbook Sign the guestbook 
[No Entries] 
Blog ++ aK 
admin (admin) Blog 
No results 
Photo Album tielo 
admin (admin) # Photo Album 
[No photos} 
Permalinks 


4 Change the default administrator password to a secure password: 
4a Click Profile, then in the upper right corner of the Profile page, click Edit. 


4b Specify your own password for the Vibe administrator in the New Password and Confirm 
New Password fields. 


4c (Optional) Provide useful information in the additional fields of the Vibe administrator’s 
profile. 


4d Click OK to return to the administrator’s profile. 
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5.2 Creating a User 


For testing purposes or for a very small Novell Vibe site, you can create each Vibe user manually. 


1 
2 


N Oo Of BB W 


10 


Log in as the Vibe administrator. 

Click the Settings icon EJ in the upper right corner of the page, then click the Administration 
Console icon E. 

In the Management section, click User Accounts. 

In the Add Account tab, provide the user’s information, then click OK. 

Specify at least the user ID, password, first name, and last name. 

(Optional) Provide useful information in the additional fields for the new user. 

Click OK, then click Close to return to the administrator’s workspace. 


If you click the Workspace tree icon è , then expand Personal Workspaces, you see that the 
workspace for the user you just created does not exist yet. Workspaces are not created for users 
until the users log in for the first time. 


Click the Settings icon [EB in the upper right corner of the page, then lick Log Out to log out as 
the Vibe administrator. 


On the login page, provide the username and password for the Vibe user you just created, then 
click OK to log in to the Vibe site. 


Click My Workspace in the Action toolbar to see the workspace for the new user. 


Novell. Vit Jade Sumi | Log Out | $$ 


¢ & e (O) My Workspace 42 Whats New MyFavorites ™ MyTeams % RecentPlaces ™ Workspace % View ™ 2 Ga 
Jade Sumi = aoe 
Jade Sumi (jsumi) Profile 
(@ Blog z 
What are you working oi 
E Calendar at are you working on 
L Files | 
Ba Guestbook 
Tasks Accessory Panel w 7 
(A trash 
Tasks 0009 - 
Task Name Priority Due Date Status Assigned to % Done Location 
Guestbook 0009. 
admin (admin) // Guestbook Sign the guestbook 
Bio 0000- 
admin (admin) // Blog 
No results 
Photo Album 0000- 


admin (admin) // Photo Album 
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admin | LogOut | WF 


«è & ()MyWorkspace ©What'sNew My Favorites ™“ MyTeams ™ RecentPlaces % Workspace M View % ne 
Jade Sumi (jsumi) Profile 
= Blog 
E Calendar What are you working on? 
Ü Files j 
GA Guestbook E 
lira EEES CE e 
Tasks 
ta Accessory Panel u 7 
4 Trasi 
Tasks t+ pe 
[No Entries] 
Task Name Priorit ity Due Date Status Assignedto % Done Location 
Guestbook t+ ge 
Jade Sumi (jsumi) # Guestbook Sign the guestbook 
[No Entries] 
Blog t+ aks 
Jade Sumi sumi) # Blog 
No results 
Photo Album tia bo 


Jade Sumi sumi) # Photo Album 


[No photos} 


As each new user logs into the Vibe site, a personal workspace is created. 


11 Click Log Out to leave the new user’s personal workspace. 


Adding Vibe Users from Your LDAP Directory 


Unless you have a very small Novell Vibe site, you create Vibe users by synchronizing their user 
information from an LDAP directory service such as Novell eDirectory or Microsoft Active Directory. 


IMPORTANT: For a large Vibe site with thousands of users, the synchronization process can 
consume substantial server resources and can take some time to complete. Perform the initial import 
from the LDAP directory at a time when this processing does not conflict with other activities on the 
server. 


If the LDAP server requires a secure SSL connection in order to access the directory service, 
create a public key certificate for the Vibe server. 


For instructions, see “Securing LDAP Synchronization” in “Site Security” in the Novell Vibe 3.4 
Administration Guide. 


Log in to the Vibe site as the Vibe administrator. 
Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon EG 


Under System, click Configure LDAP, then click Add a New LDAP Source to add an LDAP 
directory as a source for synchronizing user information. 


IMPORTANT: You can add multiple LDAP directory sources. However, do not add a new LDAP 
source to be used as a failover support for an LDAP directory that you have already specified. 


Fill in the following fields based on the information you gathered on the Basic Vibe Installation 
Summary Sheet: 
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Configure LDAP Synchronization 


New LDAP connection 


Configuration for: Idap://137.65.67.217 


The LDAP server URL format is, Idsp:i/host:port For example: Idap:/ilocalhost:389 
LDAP server URL 


User DN 


Password 


For eDirectory use GUID. For Active Directory use objeciGUID. 
LDAP attribute that uniquely identifies a user or group: 


Users 


LDAP attribute used for Vibe name: | uid 


In the box below, map the internal identifiers to the LDAP attribute names of the user record. Use the following syntax: 
internallD=IdapAttName 


firstName=gn 
emailAddress=mail 
lastName=sn 
IdapGuid=cn 
description=description 
phone=telephoneNumber 
lastName=surname 
firstName=givenName 


Base DN 


(|(objectClass=Person)(objectClass=orgPerson)(objectClass=inett 


Filter 


MM] Search Subtree 


Add 


LDAP Server URL 

User DN 

Password 

LDAP attribute that uniquely identifies a user or group 
LDAP attribute used for Vibe name 

Base DN 


Set the following synchronization options based on the information you gathered on the Basic 
Vibe Installation Summary Sheet: 
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Ss) 


Enable Schedule 


© Run Immediately 
Schedule 
) Every Day 


@ Weekly (on selected days) 
HAaMmMm mem 
Sun Mon Tue Wed Thu Fri Sat 


® AtTime 12[w]:| 15[w] GMT 


) Repeat Every 0.25 |w| Hours 


Users 


V| Synchronize User Profiles 


K 


Register LDAP User Profiles Automatically 
IL] Delete Users That are notin LDAP 


] When Deleting Users, Delete Associated User Workspaces and Content 


Use the following time zone when creating new users. 


(GMT 0:00) Greenwich Mean Time (GMT) my 


Use the following locale when creating new users. 


English (United States) [English (United States)] X 


Groups 


MI Synchronize Group Profiles 
O Register LDAP Group Profiles Automatically 


[a Synchronize Group Membership 


E| Delete Local Groups That Are Not in LDAP 


Local user accounts 


E] Allow Login for Local User Accounts, (i.e., user accounts not in LDAP) 


cD cose ) 


Enable Schedule 
Synchronize User Profiles 
Register LDAP User Profiles Automatically 


7 Click Apply to save the information and settings. 
8 Select Run Immediately, then click Apply to test LDAP synchronization. 


A status box displays the users and groups that have been added, modified, or deleted on the 
Vibe site. 


IMPORTANT: If you used an LDAP user attribute of uid and some users were not synchronized 
from the LDAP directory to Vibe, repeat the procedure and use cn instead of uid. 


The usernames admin and guest are reserved for use by Vibe. If your LDAP directory includes 
users with these names, LDAP information for these reserved usernames is not imported into 


the Vibe site. 
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9 Click Close to close the status box, then click Close to close the Configure LDAP 
Synchronization page. 


Vibe performs one-way synchronization from the LDAP directory to your Vibe site. If you change 
user information on the Vibe site, the changes are not synchronized back to your LDAP directory. 


IMPORTANT: At this point, users could log into the Vibe site by using their eDirectory or Active 
Directory usernames and passwords. However, you should not invite users to visit the Vibe site until 
after you have finished setting up the Vibe site, as described in “Site Setup” in the Novell Vibe 3.4 
Administration Guide. 
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Updating Your Vibe License 


Several different Vibe licenses are available: 
* Evaluation License: Available from Novell Downloads (http://download.novell.com). 


You receive your 60-day evaluation license when you download the evaluation version of Vibe. 


¢ Starter Pack License: Available from Novell Downloads (http://download.novell.com) and from 
the Novell Vibe Starter Pack Web page (http://www.novell.com/products/teaming/ 
starterpack.html). 


You receive your 10-user starter pack license when you download the 10-user starter pack. 
¢ Standard Vibe License: Purchased through a Novell sales representative or Novell partner. 

The Standard Vibe License gives full Vibe functionality on a per-user basis. 

After you purchase the Standard Vibe License, you can access your license key or view your 

purchase history in the Novell Customer Center (http:/Avww.novell.com/customercenter). 


If you originally installed Vibe with an Evaluation License or a Starter Pack License, it is easy to 
update your Vibe site with a new license file. 


1 Copy the new license file that you downloaded from one of the sources listed above into the 
directory where you originally ran the Vibe installation program. 

Rename the existing license-key.xm1 file to a different name. 

Rename the new license file to license-key. xml. 

Stop Vibe. 


Run the Vibe Installation program, select the Reconfigure Settings option, then select the Basic 
Installation option. 


a fF OO N 


6 Click Next through all the installation program pages, then click Install to update your Vibe 
license. 


7 Start Vibe. 
8 Log in to the Vibe site as the Vibe administrator. 
9 Click the Settings icon EJ in the upper right corner of the page, then click the Administration 
Console icon EG 
10 Under Management, click License. 
You should see the contents of the new license file. 
11 Click Close. 


At any time, you can generate a report of license usage, as described in “License Report” in “Site 
Maintenance” in the Novell Vibe 3.4 Administration Guide. 
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Setting Up Vibe 


After you have installed and started Novell Vibe, there are still administrative tasks to perform before 
your Vibe site is ready for users to log in and use Vibe efficiently. Refer to the following sections of the 
Novell Vibe 3.4 Administration Guide as you finish setting up your Vibe site. 

* “Setting Up Initial Workspaces” 

* “Planning and Controlling User Access to Workspaces and Folders” 

* “Setting Up User Access to the Vibe Site” 

* “Setting Up Site-Wide Customizations” 

¢ “Configuring Vibe to Support WebDAV on Windows 7” 

¢ “Configuring E-Mail Integration” 

¢ “Configuring Weekends and Holidays” 

¢ “Configuring Real-Time Communication Tools” 

+ “Enabling Custom JSPs to Be Used on Your Vibe Site” 

+ “Enabling Custom JAR Files to Be Used on Your Vibe Site” 

* “Setting Up Mirrored Folders” 

* “Setting Up Zones (Virtual Vibe Sites)” 

* “Adding Software Extensions to Your Vibe Site” 

* “Using Remote Applications on Your Vibe Site” 


¢ “Managing a Multiple-Language Vibe Site” 


Setting Up Vibe 85 


86 Novell Vibe 3.4 Installation Guide 


Installation Program Field 
Vibe Server Platform: 


* Windows 


* Linux 


Value for Your Vibe Site 


8 Basic Vibe Installation Summary Sheet 


Explanation 


See Section 3.2.1, “Vibe Server 
Platform,” on page 36. 


Vibe Server Architecture: 


+ 32-bit 
* 64-bit 


See Section 3.2.2, “Vibe Server 
Architecture,” on page 36. 


Vibe Server Memory: 


* 4GB 
* 8GB 


* More 


See Section 3.2.3, “Vibe Server 
Memory,” on page 37. 


Java Development Kit (JDK): 


* Sun JDK 
* IBM JDK 


See Section 3.3, “Selecting a 
Java Development Kit,” on 
page 39. 


Vibe Installation Locations: 
* Software 
Linux default: 
/opt /novell/teaming 
Windows default: 


c:\Program 
Files\Novell\Teaming 

* File repository 
Linux default: 
/var/opt/novell/teaming 
Windows default: 


c:\Novell\Teaming 


See Section 3.2.4, “Vibe 
Installation Locations,” on 
page 38. 


TrueType Font Location: 
Default: 


/usr/X11R6/lib/X11/fonts/ 
truetype 


See Section 3.2.5, “TrueType 
Font Location (Linux Only),” on 
page 39. 
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Installation Program Field 


Vibe Site Locale: 


Language: 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


Chinese-Simplified 
Chinese Traditional 
Danish 

Dutch 

English 

French 

German 
Hungarian 
Japanese 

Polish 

Portuguese 
Russian 

Spanish 

Swedish 


Country: 


Value for Your Vibe Site 


Explanation 


See Section 3.11, 
“Accommodating Multiple 
Languages,” on page 58. 


User ID for Novell Vibe (Linux only): 


+ 


+ 


User ID: 
Full name: 


Password: 


Group ID: 


Network Information: 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


Host: 

HTTP port: 80 

Secure HTTP port: 443 
Listen port: 8080 
Secure listen port: 8443 
Shutdown port: 

AJP port: 


WebDAV Authenticaiton Method: 


+ 


+ 


basic 


digest 
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See Section 3.9.2, “Linux User ID 
for Vibe,” on page 51. 


See Section 3.4, “Gathering 
Network Information for Your Vibe 
Site,” on page 39. 


See Section 3.5, “Planning the 
WebDAV Authentication Method,” 
on page 42. 


Installation Program Field Value for Your Vibe Site 


Explanation 


Database Type: See Section 3.6.1, “Database 
è MySOL Type,” on page 44. 
* Microsoft SQL 
* Oracle 

JDBC URL: See Section 3.6.3, “Database 


* Hostname: 


* Port number: 
Database Credentials: 


* Username: 


* Password: 


Location,” on page 45. 


See Section 3.6.4, “Database 
Credentials,” on page 46. 


Database Setup Method: 
* During installation (automatically by 
the Vibe Installation program) 


* Before installation (manually by 
your database administrator) 


See Section 3.6.2, “Database 
Setup Method,” on page 45. 


Database Encryption Algorithm: 
* SHA 
* SHA-256 
* MD5 
* PBEWithMD5AndDES 
Java JDK Location: 
* Java home: 


+ JVM heap size: 


See Section 3.6.5, “Database 
Encryption Algorithm,” on 
page 46. 


See Section 3.3, “Selecting a 
Java Development Kit,” on 
page 39. 


Outbound E-Mail Protocol: 


* SMTP 
* SMTPS 


See Section 3.7.1, “Outbound E- 


Mail Protocol,” on page 47. 


Outbound E-Mail Host: 


* Hostname: 
* SMTP port: 
Default: 25 
* Time zone 
+ Continent/region: 
+ Country/state: 


* City: 


See Section 3.7.2, “Outbound E- 


Mail Host,” on page 48. 
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Installation Program Field Value for Your Vibe Site 
Outbound E-Mail Authentication: 


* Username: 
* Password: 


+ Authentication required? No / Yes 


Explanation 


See Section 3.7.3, “Outbound E- 
Mail Authentication,” on page 48. 


Allow Sending E-Mail to All Users 


Yes / No 


See Section 3.7.4, “Outbound E- 
Mail Send Restriction,” on 
page 49. 


Inbound E-Mail Configuration 


* Enable: No / Yes 
+ SMTP bind address: 
* SMTP port: 


* Announce TLS: Yes / No 


See Section 3.8, “Enabling 
Inbound E-Mail,” on page 49. 


Vibe Site Password: 


* Administrator username: admin 
* Default password: admin 


* Your password: 


See Section 3.9.1, “Vibe Site 
Administrator Password,” on 
page 51. 


LDAP Directory Service: 


* Novell eDirectory 
* Microsoft Active Directory 


* Other LDAP directory 


See Section 3.10, “Gathering 
Directory Services Information,” 
on page 51. 


LDAP Server: 


* LDAP server URL: 
* User DN: 


* Password: 


See “LDAP Server” on page 52. 


LDAP Attribute to Identify User: 
* GUID 


screenName=GUID 
* object GUID 


screenName=objectGUID 


See “LDAP Attribute to Identify a 
User or Group” on page 53. 


LDAP Attribute for Vibe Name: 
* cn 


screenName=cn 
* uid 


screenName=uid 
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See “LDAP Attribute for Vibe 
Name” on page 54. 


Installation Program Field Value for Your Vibe Site 


LDAP User Search Context: 


* Base DNs: 
+ Additional filter attributes: 


* Search subtree: Yes / No 


Explanation 


See “User and Group Object 
Locations” on page 54. 


LDAP Group Search Context: 


* Base DNs: 
+ Additional filter attributes: 


* Search Subtree: Yes / No 


See “User and Group Object 
Locations” on page 54. 


LDAP Synchronization Schedule: 
* Days 
* Every day 
* Weekly 
Sun Mon Tue Wed Thu Fri Sat 


* Hours: 
* Attime: 


* Repeat every nn hours 


” 


See “Synchronization Schedule 
on page 56. 


LDAP User Options: 


¢ Synchronize user profiles 


* Register LDAP user profiles 
automatically 


* Delete users that are not in LDAP 


* When deleting a user, delete 
associated user workspaces and 
content 


* Time zone for new users 


See “User Synchronization 
Options” on page 56. 


LDAP Group Options: 


* Synchronize group profiles 


+ Register LDAP group profiles 
automatically 


* Synchronize group membership 


* Delete local groups that are not in 
LDAP 


See “User Synchronization 
Options” on page 56. 
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Advanced Installation and 
Reconfiguration 


* Chapter 9, “Planning an Advanced Vibe Installation,” on page 95 

* Chapter 10, “Performing an Advanced Vibe Installation,” on page 119 

* Chapter 11, “Setting Configuration Options after Installation,” on page 121 
* Chapter 12, “Advanced Vibe Installation Summary Sheet,” on page 123 
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Q Planning an Advanced Vibe Installation 


9.1 


The Advanced installation provides additional options for you to customize Novell Vibe. 


* Section 9.1, “What Is an Advanced Installation?,” on page 95 

* Section 9.2, “Distributing Different Data Types to Different Locations,” on page 96 

* Section 9.3, “Using Advanced Network Information Settings,” on page 97 

* Section 9.4, “Configuring Requests and Connections Configuration,” on page 98 

¢ Section 9.5, “Configuring Web Services,” on page 99 

* Section 9.6, “Changing Your Lucene Index Server Configuration,” on page 99 

* Section 9.7, “Managing RSS Feeds,” on page 101 

* Section 9.8, “Configuring Presence,” on page 102 

* Section 9.9, “Configuring Single Sign-On with Novell Access Manager,” on page 103 


¢ Section 9.10, “Configuring Single Sign-On with Internet Information Services for Windows,” on 
page 103 


* Section 9.11, “Configuring Mirrored Folder Resource Drivers,” on page 116 
* Section 9.12, “Installing the Vibe Software in a Clustered Environment,” on page 118 


As you proceed with planning, you can use the Advanced Vibe Installation Summary Sheet to record 
your decisions about the options you want to use. 


What Is an Advanced Installation? 


In addition to the Basic installation options described in Section 3.1, “What Is a Basic Vibe 
Installation?,” on page 35, the installation program for Vibe provides several advanced installation 
and configuration alternatives. You can implement the advanced options after performing a Basic 
installation, or you can have the installation program present all the options together. 


Compared to a Basic installation, an Advanced installation offers the following additional options: 


* Changing the session timeout 

¢ Specifying a keystore file 

¢ Specifying different directories for different types of data 

¢ Configuring requests and connections configuration 

¢ Disabling and enabling four different Web services 

* Changing the configuration of the Lucene Index Server 

¢ Configuring a remote Lucene Index Server or a group of high-availability Lucene nodes 
+ Reconfiguring how RSS feeds are retained or disabling them entirely 

¢ Enabling presence in conjunction with Novell Messenger 

+ Configuring a reverse proxy to accommodate single sign-on 


+ Configuring Windows Authentication 
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9.2 


¢ Configuring mirrored folders 
¢ Installing Vibe in a clustered environment 


IMPORTANT: The following Vibe configurations require that you perform an Advanced installation as 
your initial installation of the Vibe software: 


* Setting up the Vibe file repository so that some types of files are located outside the Vibe file 
repository root directory. See Section 9.2, “Distributing Different Data Types to Different 
Locations,” on page 96 for Advanced installation instructions. You cannot move subdirectories 
within the Vibe file repository after they have been created. 


¢ Installing the Vibe software on multiple servers to create a clustered environment. See 
Chapter 15, “Running Vibe on Multiple Servers,” on page 139 for Advanced installation 
instructions. The option to enable a clustered environment is available only during an Advanced 
installation. 


If you want to implement an Advanced installation option, you should perform a Basic installation first, 
in a test environment, before performing the Advanced installation to set up your permanent Vibe site. 


Distributing Different Data Types to Different 
Locations 


The default location for the Novell Vibe file repository varies by platform: 


Linux: /var/opt/novell/teaming 


Windows: c:\Novell\Teaming 


Under the main Vibe file repository root directory are subdirectories for various kinds of data files that 
are not stored in the Vibe database (MySQL, Microsoft SQL Server, or Oracle). You can use an 
Advanced installation to store Vibe data files in various locations. 


The data files not stored in the Vibe database are divided into several functional areas: 
* Simple file repository: A large consumer of disk space. 


All attachment files are stored in the file repository. All versions of files are also stored here. 


* Jackrabbit repository: (Optional) Takes only a fraction of the space consumed by the file 
repository. 


By default, Vibe stores all data files individually on disk, in the file repository. If you prefer to store 
data files in the database itself, you can use Apache Jackrabbit with Vibe. See the Apache 
Jackrabbit Web site (http://jackrabbit.apache.org) for setup instructions. 


* Extensions repository: Disk space consumption depends on the number of extensions you 
add to your Vibe site. 


An extension is a software program that you can incorporate into your Vibe site in order to 
enhance (extend) Vibe capabilities. Adblock Plus is an example of a Firefox browser extension 
that filters out advertisements. You or a Java developer can create custom extensions for your 
Vibe site. For more information about creating and using Vibe extensions, see the Novell Vibe 
3.4 Developer Guide. 


* Archive store: A large consumer of disk space. 
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9.3 


9.3.1 


When entries are deleted, files that were attached to the deleted entries are retained in the 
archive store in order to meet compliance and archival goals. Previous versions of documents 
are also retained in the archive store. After files have been archived, they are inaccessible from 
the Vibe site. Files that accumulate in the archive store must be manually deleted as needed to 
manage the disk space occupied by the archive store. 


* Cache store: Consumes less disk space than the file repository. 


Information derived from the attachments, such as thumbnails, HTML renderings, scaled 
images, and word lists for indexing are stored in the cache store. 


* Lucene index: Takes only a fraction of the space consumed by the file repository. 


The Lucene index contains only pointers to the actual data stored in the file repository. The index 
enables the Lucene search engine to perform very fast searches through large quantities of 
data. 


The directories for the various types of data can be on the Vibe server or on a remote server. Data 
access is fastest if the data is local, but depending on the size of your Vibe site and the types of data 
you store, the Vibe server might not be the best place to store all the Vibe data. If you want to store 
any of the data types on a remote server, you must ensure that the remote location of the data 
appears local to the Vibe server and that it is always available with read/write access. 

Linux: Mount the file repository to the Vibe server. 


Windows: Map a drive from the Vibe server to the file repository. 


Linux and Place the file repository on a SAN (storage area network) with read/write access. This alternative 

Windows provides the most reliable remote location for the Vibe file repository. This is required for a 
clustered environment, as described in Chapter 15, “Running Vibe on Multiple Servers,” on 
page 139. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Data Locations, specify the directories where you want to store the various types of Vibe data. 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Using Advanced Network Information Settings 


* Section 9.3.1, “Changing the Vibe Session Timeout,” on page 97 


* Section 9.3.2, “Providing a Secure Keystore File,” on page 98 


Changing the Vibe Session Timeout 
By default, if a user's Novell Vibe session is idle for four hours (240 minutes), Vibe logs the idle user 


out. For increased convenience to Vibe users, you can make the session timeout interval longer. For 
increased security for your Vibe site, you can make the session timeout shorter. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the session timeout interval (in minutes) for your Vibe site. 
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9.3.2 


9.4 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Providing a Secure Keystore File 


For your convenience, the Vibe software includes a self-signed public certificate that enables you to 
specify secure HTTP and listen ports during installation. This certificate is stored in the . keystore file 
in the following directory: 


Linux: /opt/novell/teaming/apache-tomcat/conf 


Windows: c:\Program Files\Novell\Teaming\apache-tomcat\conf 


To ensure secure SSL connections for your Vibe site, you should replace the self-signed public 
certificate with a public certificate issued by a valid certificate authority. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the name and location of the public certificate. 


If you do not already have a permanent public certificate for your Vibe server, see “Securing HTTP 
Browser Connections” in “Site Security” in the Novell Vibe 3.4 Administration Guide. 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Configuring Requests and Connections 
Configuration 


You can configure the number of client requests and database connections that Vibe is able to 
support. 


If you have an extremely large Vibe site and you need to make numerous client requests and 
database connections, you might see improved performance by increasing these settings. 


* Max Threads: The maximum number of simultaneous client request threads that Vibe is able to 
support. The default is 200 threads. 


* Max Active: The maximum number of database connections that can be allocated from this pool 
at the same time. 


If your database server license (for Oracle or MS SQL) restricts you from having more 
connections than the Vibe default of 50, you must specify a number that does not exceed your 
database server license. 


* Max Idle: The maximum number of database connections that can be idle in this pool at the 
same time. The default is 20 connections. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Requests and Connections Configuration, mark the maximum client request threads, maximum 
active database connections, and maximum idle database connections. 


Novell Vibe 3.4 Installation Guide 


9.5 


9.6 


9.6.1 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Configuring Web Services 


When you install and set up your Novell Vibe site, three Web services are enabled by default. A fourth 
is available for selection. These Web services enable programs to access information on your Vibe 
site just as users would. Allowing programmatic access to your Vibe site can be useful or can be 
viewed as a security risk. 

+ WSS authentication: Uses OASIS Web Services Security (WSS) (http://mww.oasis-open.org). 


+ HTTP Basic authentication: Uses HTTP Basic Access authentication (http://tools.ietf.org/html/ 
rfc2617). 


* Token-based authentication: Uses custom Vibe tokens to communicate with Vibe remote 
applications. For more information, see “Using Remote Applications on Your Vibe Site” in “Site 
Setup” in the Novell Vibe 3.4 Administration Guide. 


* Anonymous access: Allows access to your Vibe site without authentication. It is similar to the 
Guest access provided for users, as described in “Allowing Guest Access to Your Vibe Site” in 
“Site Setup” in the Novell Vibe 3.4 Administration Guide. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Web Services, mark which Web services you want enabled for your Vibe site. The first three are 
enabled by default. The fourth is disabled by default. 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Changing Your Lucene Index Server Configuration 


The default Lucene Index Server configuration is appropriate for a medium-sized Novell Vibe site. If 
you have a larger Vibe site, you can change its Lucene Index Server configuration. 

* Section 9.6.1, “Understanding Indexing,” on page 99 

¢ Section 9.6.2, “Changing Lucene Configuration Settings,” on page 100 

¢ Section 9.6.3, “Running the Lucene Index Server in Its Own JVM,” on page 100 

* Section 9.6.4, “Running the Lucene Index Server on a Remote Server,” on page 101 

¢ Section 9.6.5, “Running Multiple Lucene Index Servers,” on page 101 
After planning your Lucene configuration, complete the planning process for additional Advanced 


installation features as needed, then perform the Advanced installation as described in Chapter 10, 
“Performing an Advanced Vibe Installation,” on page 119. 


Understanding Indexing 
The Lucene Index Server is responsible for indexing all data on the Vibe site so that Vibe users can 


easily use the Find and Search features to retrieve the information that they need. Text posted in 
folder entries is easy to index, because the formatting is simple. However, text in attached files arrives 
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9.6.2 


9.6.3 


in many different file formats, many of which require conversion before the text in the files can be 
indexed. Therefore, the Lucene Index Server is dependent on the available file conversion 
technology in order to perform its indexing function. For information about the file viewers that Vibe 
uses, see Section 2.5.1, “File Viewer Support,” on page 24. 


The Lucene Index Server provides additional services on your Vibe site in addition to indexing. In 
fact, you cannot access your Vibe site if the Lucene Index Server is not running. For this reason, 
Novell Vibe provides multi-server Lucene configuration options that are not available in Kablink Vibe. 


Changing Lucene Configuration Settings 


If you have an extremely large Vibe site and you need to reindex the Vibe data, you might see 
improved performance by increasing these settings. 


+ Max booleans: The default is 10000. This means that 10,000 Boolean clauses are allowed in a 
query. You need to increase this only if your Vibe site includes more than 10,000 users, groups, 
or teams. 


* RAMin MB that may be used for buffering: The default is 256 MB for remote and high 
availability Lucene configurations and 32 MB for local Lucene configurations. This is the amount 
of RAM that is allocated for buffering documents and deletions before they are flushed to the 
directory. (This setting can be changed only in the Lucene installer; it is not available in the Vibe 
installer.) 


+ Merge factor: The default is 10. This sets the number of index segments that are created on 
disk. When additional index segments are needed, existing segments are merged to keep the 
merge factor constant. 


* Network interface for RMI service: (Optional) Specify the IP address or hostname for the 
network interface for the RMI (Remote Method Invocation (http://java.sun.com/javase/ 
technologies/core/basic/rmi/index.jsp)) service. 


This is the hostname of the server where the Lucene Index is installed. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Lucene Configuration, specify any Lucene configuration settings that you want to change. 


Running the Lucene Index Server in Its Own JVM 


By default, the Lucene Index Server runs in the same Java Virtual Machine (JVM) as the Vibe 
software. To leave more memory available for the Novell Vibe software, you can configure the Lucene 
Index Server to run in a separate JVM. In this configuration, it communicates with the Vibe software 
using the RMI (Remote Method Invocation (http://java.sun.com/javase/technologies/core/basic/rmi/ 
index.jsp)) port, which by default is 1199. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Lucene Configuration, specify a hostname of localhost. Use the default RMI port number 
unless it is already in use on the server. 


To change from running the Lucene Index Server in the same JVM with Vibe to running it in its own 
JVM, you must complete the same steps that you use for setting up the Lucene Index Server on a 
remote server. This includes manually installing the Lucene Index Server software on the Vibe server, 
as described in Chapter 14, “Installing the Lucene Index Server on a Remote Server,” on page 135. 


100 Novell Vibe 3.4 Installation Guide 


9.6.4 


9.6.5 


9.7 


9.7.1 


9.7.2 


Running the Lucene Index Server on a Remote Server 


If the Lucene Index Server requires more memory, disk space, or CPU resources than are available 
on the Novell Vibe server, you can move it to a remote server. This requires installing the Lucene 
Index Server software on that server. For instructions, see Chapter 14, “Installing the Lucene Index 
Server on a Remote Server,” on page 135. 


Running Multiple Lucene Index Servers 


Because the availability of the index is critical to the functioning of the Novell Vibe site, you can install 
multiple Lucene Index Servers on multiple remote servers to provide high availability. For instructions, 
see Chapter 16, “Running Multiple Lucene Index Servers,” on page 147. 


Managing RSS Feeds 


By default, Novell Vibe users can set up RSS feeds in folders on the Vibe site, as described in 
“Viewing Folders as RSS or Atom Feeds” in “Getting Informed” in the Novell Vibe 3.4 User Guide. 


* Section 9.7.1, “Configuring RSS Feeds,” on page 101 
* Section 9.7.2, “Disabling RSS Feeds,” on page 101 


After planning the RSS settings, complete the planning process for additional Advanced installation 
features as needed, then perform the Advanced installation as described in Chapter 10, “Performing 
an Advanced Vibe Installation,” on page 119. 


Configuring RSS Feeds 


The following aspects of RSS functionality on your Vibe site are configurable: 


* Max elapsed days: By default, items from RSS feeds are retained on the Vibe site for 31 days. 
You can decrease the number of days to reduce the amount of disk space occupied by the RSS 
files. 


+ Max inactive days: By default, if no one on the Vibe site accesses an RSS feed for 7 days, the 
feed is no longer updated. Increase or decrease the retention time for inactive feeds to meet the 
needs of Vibe users and disk space considerations. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under RSS Configuration, specify the number of days that meet the needs of your Vibe site. 


Disabling RSS Feeds 


Some administrators consider RSS feeds to be a security risk because the RSS feed URL includes 
username and password information. If you do not want Vibe site users to be able to subscribe to 
RSS feeds from the Vibe site, you can disable this feature. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under RSS Configuration, mark No. 
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9.8 


Configuring Presence 


If you are using Novell Messenger as your instant messaging solution, you can configure Novell Vibe 
to display a user’s Messenger presence information. For information about where presence 
information is displayed in Vibe, see “Sending an Instant Message from within Vibe” in the Novell Vibe 
3.4 User Guide. 


When you click a user’s presence icon, the Profile Quick View is displayed, which enables you to 
send an instant message to the user, view the user’s personal workspace, follow the user, and more. 


In order to configure Messenger presence to be displayed in Vibe, you need the following information 
about the Messenger system during the Vibe installation: 


* Server address: Specify the IP address or DNS hostname of the messaging agent for your 
Messenger system. 
¢ Port: Specify the port number. 


* Server user: Specify the fully typed, comma-delimited context username of the Allowed Service 
User that you want to log in to the Messenger system and retrieve presence information. 


For example, cn=vibesvc, o=acme 


For more information about the Allowed Service User, see “Integrating Novell Vibe with Novell 
Messenger” in the Novell Messenger 2.2 Administration Guide. 


* Password: Specify the password for the Allowed Service User that you want to log in to the 
Messenger system and retrieve presence information. 


For more information about the Allowed Service User, see “Integrating Novell Vibe with Novell 
Messenger” in the Novell Messenger 2.2 Administration Guide. 


* Server Certificate: Browse to and select the Messaging Agent's SSL certificate. Vibe uses this 
certificate to identify the Messenger server. 


If Messenger is installed on a separate server, copy the certificate from the Messenger server 
and place it in a location on the Vibe server that can be reached from the Vibe installation 
program. 


The certificate is located in the following directory on the Messenger server: 


Linux: /opt/novell/messenger/certs 


Windows: c:\Novell\Messenger\certs 


To remove the certificate after you have already selected it, click Browse > Cancel. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Presence Configuration, select Enable Novell Messenger Presence, then list the information that 
the Vibe site needs to know in order to communicate with the Messenger system. 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


IMPORTANT: For Messenger presence to display in Vibe when using LDAP, you need to map 
presenceID to your authentication attribute in the Vibe LDAP configuration page. For example, 
presenceID=cn. For more information, see “Configuring Presence” in the Novell Vibe 3.4 
Administration Guide 
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9.10 


Configuring Single Sign-On with Novell Access 
Manager 


Novell Access Manager provides secure single sign-on access to your Novell Vibe site by functioning 
as a reverse proxy server. Access Manager 3.1 SP1 IR1 is required for use with Novell Vibe. You can 
download the required version of Access Manager from Novell Downloads (http:// 
download.novell.com). 


For background information about setting up Novell Access Manager 3.1, see the Access Manager 
3.1 Documentation Web site (http://www.novell.com/documentation/novellaccessmanager31). For 
instructions specific to Vibe, see “Configuring a Protected Resource for a Novell Vibe Server” in the 
Novell Vibe 3.4 Administration Guide. 


After you have configured Novell Access Manager, you must configure your Vibe site with the IP 
address of one or more Access Gateway servers and with the logout URL. When you configure the 
Vibe site to use the Access Gateway, the IP addresses that you specify are the only locations from 
which the Vibe site accepts logins. The logout URL is the location where users find themselves when 
they log out of the Vibe site. 


When you enable the Access Gateway for use with your Vibe site, all Vibe users must log in through 
the Access Gateway. It is not possible to set up the Vibe site so that some users log in through the 
Access Gateway and some do not. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Reverse Proxy Configuration, list one or more IP addresses of Access Gateway servers that have 
been configured for use by Vibe. List the logout URL, and if necessary, the Access Gateway hostname 
for WebDAV connections. 


Complete the planning process for additional Advanced installation features as needed, then perform 
the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


Configuring Single Sign-On with Internet 
Information Services for Windows 


Like Novell Access Manager, Windows Authentication provides Windows users with a single sign-on 
experience, enabling users to automatically authenticate to Novell Vibe after they log in to their 
individual workstations. Internet Information Services (IIS) provides this capability. 


Before you implement Windows Authentication, consider the following limitations: 


* IIS is best suited for an intranet environment. Because NTLM is a connection-based protocol, it 
does not work well with HTTP proxy servers. 


* IIS does not support Guest Access. 


After you configure the Vibe server to support Windows Authentication, complete the planning 
process for additional Advanced installation features as needed, then perform the Advanced 
installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on page 119. 

* Section 9.10.1, “System Requirements,” on page 104 

* Section 9.10.2, “Planning Your IIS Installation and Configuration,” on page 105 

* Section 9.10.3, “Configuring the Vibe Server to Support Windows Authentication,” on page 106 
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* Section 9.10.4, “Running the Vibe Installation Program,” on page 112 
* Section 9.10.5, “Configuring Your Browser to Allow Access to the Vibe Site,” on page 112 


* Section 9.10.6, “Bypassing Windows Authentication to Configure LDAP and Perform Other 
Tasks,” on page 113 


* Section 9.10.7, “Logging In to the Vibe Site through Windows Authentication,” on page 113 
* Section 9.10.8, “Editing Files through WebDAV with Windows Authentication,” on page 114 
¢ Section 9.10.9, “Configuring IIS to Allow Uploading of Large Files to the Vibe Site,” on page 115 


* Section 9.10.10, “Configuring IIS to Load Balance in a Clustered Environment,” on page 115 


System Requirements 


Windows Authentication with IIS can be enabled for Vibe only in the following environments: 


Server 


* Windows 2008 Server 
* Windows 2008 R2 Server 


IIS 


¢ IIS 7 with IIS Manager with CGI and ISAPI components 
¢ IIS 7.5 with IIS Manager with CGI and ISAPI components 


Authentication Protocol 


One of the following authentication protocols: 


* NTLM 
* Kerberos v5 
* Negotiate/SPNEGO (wrapper for NTLM and Kerberos v5) 


Domain Controller 


* Active Directory Service 


Vibe needs to be configured and synchronized with your Active Directory directory service. For 
more information about configuring LDAP synchronization within Vibe, see Section 3.10, 
“Gathering Directory Services Information,” on page 51 and “Synchronizing Users and Groups 
from an LDAP Directory” in the Novell Vibe 3.4 Administration Guide. 


If you are using Kerberos as your authentication protocol, then Key Distribution Services is also 
required. 


For more information about installing and configuring the domain controller and other domain 
services to support Windows Authentication, refer to the appropriate Microsoft documentation. 
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Client 


One of the following clients: 


+ Windows 7 
+ Windows XP 


Browser 


One of the following browsers, configured to support Windows Authentication: 


¢ Internet Explorer 


* Firefox 


For information on how to configure your browser to support Windows Authentication, see 
Section 9.10.5, “Configuring Your Browser to Allow Access to the Vibe Site,” on page 112. 


Planning Your IIS Installation and Configuration 


Use the information in the following table as you consider your IIS installation. 


Directory: The default installation directory for the IIS plug-in is C:\Program Files\Novell. 
This is the recommended directory. If for some reason you choose to install the IIS plug-in in a 
directory other than the C:\Program Files\Novel11 directory, then you need to modify the 
isapi redirect.properties files, as described in “Installing the Vibe IIS Plug-In” on 

page 106. 


External or Local Server: You can install the IIS plug-in on the same server where you are running 
Vibe, or you can install it on an external server. Installing IIS on an external server can have several 
benefits, such as: 


* Performance improvement 
* Ability to integrate with several Vibe servers in a clustered environment 


* Ability to run Vibe from a non-Windows server 


If you are running IIS from an external server, then you need to edit the C: \Program 
Files\Novell\Vibe IIS Plugin\conf\workers.properties file, as described in 
“Installing the Vibe IIS Plug-In” on page 106. 


64-bit/32-bit: You can install the IIS plug-in on a 64-bit or 32-bit operating system. However, Vibe 
should run on a 64-bit operating system, so if you install IIS on a 32-bit operating system, you 
should use an external server. 


HTTP Ports: Regardless of whether IIS and Vibe are located on the same server or separate 
servers, the HTTP port and secure HTTP port for Vibe should always be 80 and 443. This ensures 
that when links are generated, they contain the correct hostname and port number. 


These are the ports that Vibe uses to refer to the browser. In a very basic Vibe system (single server 
without Windows Authentication), the HTTP ports can be the same as the listen ports. However, in 
a Vibe system with Windows Authentication enabled, the HTTP ports correspond with the ports that 
the IIS server is configured to use. 
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9.10.3 


Listen Ports: If you plan to run IIS on the same server as the Vibe server, you need to set the listen 
port and secure listen port for Vibe to something other than 80 and 443. 


By default, Vibe listens on ports 80 and 443. Because IIS also uses these ports to listen on, you 
must reconfigure the Vibe listen ports to ports that are not currently in use, such as 8080 for the 
listen port and 8443 for the secure listen port. 


You configure Vibe ports during the Vibe installation, as described in Chapter 10, “Performing an 
Advanced Vibe Installation,” on page 119. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Network Information, specify the HTTP ports and listen ports. 


Under Integration with IIS for Windows Authentication, select Enable Integration with IIS for Windows 
Authentication, then list the logout URL. 


Configuring the Vibe Server to Support Windows 
Authentication 


To configure the Vibe server to support Windows Authentication, you must first configure IIS. You can 
set up IIS on the same server where Vibe is running, or on a separate server. See Section 9.10.2, 
“Planning Your IIS Installation and Configuration,” on page 105 for more information. 


Complete the following sections to ensure that IIS is configured correctly to work with Vibe. 


¢ “Installing the Vibe IIS Plug-In” on page 106 
¢ “Installing IIS Manager” on page 107 
¢ “Installing Windows Authentication Role Service” on page 108 


+ “Creating and Managing Vibe Resources with IIS Manager” on page 108 


Installing the Vibe IIS Plug-In 


1 Locate the teaming-version-iis-plugin. zip file from the Vibe distribution, then unzip it into 
the c:\Program Files\Novell directory. 


This creates a directory called Vibe IIS Plugin. 


2 Ifin Step 1 you chose to unzip the teaming-version-iis-plugin. zip file into the C:\Program 
Files\Novell directory, continue with Step 3. 


or 


If in Step 1 you chose to unzip the teaming-version-iis-plugin. zip file into a location other 
than c:\Program Files\Novell, you must complete the following steps: 


2a Locate the isapi redirect .properties file in each of the following directories: 
* Vibe IIS Plugin\resources1\bin 
* Vibe IIS Plugin\resources2\bin 
2b In each of the directories, open the isapi redirect .properties file in a text editor. 


2c Adjust the values of the log file, worker file, and worker mount file properties to 
reflect the directory where you chose to unzip the teaming- version-iis-plugin. zip file. 


2d Save your changes and close both of the isapi redirect.properties files. 
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3 If IIS and the Vibe server are located on the same server, continue with Step 4. 
or 
If IIS and the Vibe server are located on separate servers, complete the following steps: 


3a Locate the C:\Program Files\Novell\vibe IIS Plugin\conf\workers.properties 
file. 


3b Open the workers.properties file in a text editor. 


3c Adjust the value of the worker .worker1.host property from localhost to the hostname or 
IP address of the Vibe server. 


3d Save your changes and close the editor. 
4 (Conditional) If you are running IIS on a 64-bit server, complete the following steps: 
4a Locate the C:\Program Files\Novell\Vibe IIS Plugin\library\win64 directory. 


4b Copy the appropriate version of the .d11 library and paste it into each of the following 
directories: 


* C:\Program Files\Novell\Vibe IIS Plugin\resources1\bin 
* C:\Program Files\Novell\Vibe IIS Plugin\resources2\bin 


Ensure that you copy the correct version of the . a11 library. If you copy the incorrect 
version, you receive a 500 error when you try to access the Vibe site. 


4c Delete the existing isapi redirect .d11 files from the c:\Program Files\Novell\Vibe 
IIS Plugin\resources1\bin directory, as well as from the c:\Program 
Files\Novell\vibe IIS Plugin\resources2\bin directory. 


4d Rename the .d11 library files that you copied in Step 4b to isapi_redirect.d1l. 


For example, if Vibe is running on an AMD64/EM64T platform, copy c:\Program 
Files\Novell\Vibe IIS Plugin\library\winé4\amd64\isapi_redirect- 
version.dll into the c:\Program Files\Novell\Vibe IIS Plugin\resources1\bin 
and c:\Program Files\Novell\Vibe IIS Plugin\resources2\bin directories, then 
delete the original isapi_redirect .d11 file and rename isapi_redirect-version.dllto 
isapi_redirect.dll. 


Installing IIS Manager 


If Internet Information Services (IIS) Manager is not already installed on your server, you need to 
download and install it. You also need to install the CGI and ISAPI components. 
1 Install the IIS 7 Administration Pack: 
1a Navigate to Microsoft IIS Download Site (http://www.iis.net/download/Manage). 
1b Click the Manage tab. 
1c Under Administration Pack, click Install. 


1d (Conditional) If you have not yet installed the Microsoft Web Platform, click Get the Microsoft 
Web Platform to download the . exe file, install the Microsoft Web Platform, then click Finish 
your installation. 


The Launch Application dialog box is displayed. 
le Select Web Platform Installer, then click OK. 
The Web Platform Installer 2.0 dialog box is displayed. 


1f Click Install to install the Administration Pack, then accept the terms of the license 
agreement. 
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2 Install the ISAPI and CGI components: 
2a Launch the Web Platform Installer. 
2b From the Web Platform Installer, select Web Platform. 
2c Under Web Server, click Customize. 
2d In the Application Development section, select CGI, ISAPI Extensions, and ISAPI Filters. 
2e Click Install, then accept the terms of the license agreement. 


2f Click Finish after the components have been installed successfully. 


Installing Windows Authentication Role Service 


If the Windows Authentication Role Service is not already installed, you need to install it. 


1 On the Windows 2008 server, click Start > Administrative Tools > Server Manager. 
2 Expand Roles, then right-click Web Server (IIS). 
3 Click Add Role Services. 
The Add Role Services window is displayed. 
4 Scroll to the Security section, then select Windows Authentication. 


5 Click Next, then complete the installation. 


Creating and Managing Vibe Resources with IIS Manager 


1 Click Start > Administrative Tools > Internet Information Services (IIS) Manager. 
2 In the Connections pane on the left side of the window, expand your server, then expand Sites. 
3 Right-click Default Web Site, then click Add Virtual Directory. 

The Add Virtual Directory dialog box is displayed. 


Site name: Default Web Site 
Path: / 


Alias: 


pe 


Example: images 
Physical path: 


| 


Pass-through authentication 


Connect as... | Test Settings... | 
cc | 


4 In the dialog box, specify the following information: 
Alias: vibeResources1. 
Physical path: c:\Program Files\Novell\vibe IIS Plugin\resources1\bin. 
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5 
6 


10 


12 


Click OK. 

Repeat Step 3 through Step 5 to add another virtual directory. 

This time, specify the following information in the Add Virtual Directory dialog box: 
Alias: VibeResources2 

Physical path: c:\Program Files\Novell\Vibe IIS Plugin\resources2\bin 


In the Connections panel, select VibeResources1, then double-click Handler Mappings. 
Ps iteret information Services (US) manager TT 
(©) C [E] > PEN » Sites > Defauit web site > vbeResourcesi > |a = me- 
Fie View Help 
C) f ler in Ss 
e 42168 al ial Add Managed Handler... 
"Gy Start Page Add Script Map. 
= Use this feature to specify the resources, such as DLLs and managed code, Yi 
eG Pil that handle responses for specific request types. Add Wildcard Script Map... 
€ x - 
6- Sites Group by: State ~ Acid Moe 
E-@ Default Web Site Name + Path State Edit Feature Permissions... 
4.) VibeResourcesi Disabled Revert To Inherited 
&] VibeResources2 
= View Ordered List... 
@ Hep 
Online Hi 
Enabled gie” 
OPTIONSVerbHandler * Enabled 
TRACEVerbHandler = Enabled 
StaticFie = Enabled 
i] +| 
4 to} ee 
Configuration: Default Web Site/VibeResources1' web.config Gi: 


In the Actions pane, click Edit Feature Permissions. 
The Edit Feature Permissions dialog box is displayed. 


Gen 21x 
Permissions: 
MW Read 
M script 
MW Execute 


Lo |_ come | 


Select Execute, then click OK. 

Repeat Step 7 through Step 9 for the vibeResources2 virtual directory. 

In the Connections pane, select Default Web Site, then double-click ISAPI Filters. 
In the Actions panel, click Add. 

The Add ISAPI Filter dialog box is displayed. 
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13 


14 
15 


16 


Filter name: 


pe 


Executable: 


ee 


a 


In the dialog box, specify the following information: 
Filter name: vibeResources1. 
You must name the filter vibeResources1 for Windows Authentication to work successfully. 


Executable: c:\Program Files\Novell\Vibe IIS 
Plugin\resources1\bin\isapi_redirect.dll. 


Click OK. 

Repeat Step 12 through Step 14 to add another ISAPI filter. 

This time, specify the following information in the Add ISAPI Filter dialog box: 

Filter name: VibeResources2. 

You must name the filter vibeResources2 for Windows Authentication to work successfully. 


Executable: c:\Program Files\Novell\Vibe IIS 
Plugin\resources2\bin\isapi_redirect.dll. 


In the Connections pane, select the server, then double-click ISAPI and CGI Restrictions. 
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E Internet Information Services (IIS) Manager loj xi 
© Sa. i @- 


File View Help 


@- 17 18 


ca Start Page 
=- 84 PEN (LPTEAMING\administrator) 
@ Application Pools 
= (i Sites 
E)-@ Default Web Site 
#1] VibeResources1 
+] VibeResources2 


oy ISAPI and CGI Restrictions 
7 
Use this feature to specify the ISAPI and CGI extensions that can run on the 
Web server. 
Group by: No Grouping z 

& Restriction Path 
TeamingResourc... Allowed C:\Program Files \Novell\Teamir 
TeamingResourc... Allowed C:\Program Files \Novell\Teamir 
Pn] >I 


ammm 


Configuration: ‘localhost’ applicationHost.config 


17 Inthe Actions pane, click Add. 
The Add ISAPI or CGI Restriction dialog box is displayed. 


Add ISAPI or CGI Restriction 


ISAPI or CGI path: 


2x) 


es 
Description: 
pee 


TT Allow extension path to execute 


e] ca | 


18 In the dialog box, specify the following information: 


ISAPI or CGI path: Specify c:\Program Files\Novell\Vibe IIS 
Plugin\resources1\bin\isapi_redirect.dll. 


Description: VibeResources1. 


Gi 


Allow extension path to execute: Select this option to allow the path to execute. 
19 In the Actions pane, click Add. 
The Add ISAPI or CGI Restriction dialog box is displayed. 
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9.10.5 


Add ISAPI or CGI Restriction 2) xi 
ISAPI or CGI path: 


ee 


Description: 


ee 


n Allow extension path to execute 


E] cs | 


20 In the dialog box, specify the following information: 


ISAPI or CGI path: Specify c:\Program Files\Novell\Vibe IIS 
Plugin\resources2\bin\isapi_redirect.dll. 


Description: VibeResources2. 

Allow extension path to execute: Select this option to allow the path to execute. 
21 In the Connections pane, select VibeResources1, then double-click Authentication. 
22 Select Anonymous Authentication, then click Disable in the Actions panel. 
23 Select Windows Authentication, then click Enable in the Actions panel. 
24 Exit the Internet Information Services Manager. 


25 Perform the Advanced installation as described in Chapter 10, “Performing an Advanced Vibe 
Installation,” on page 119. 


Running the Vibe Installation Program 


See “Choosing Windows Authentication” on page 44 for information about how to configure the Vibe 
installation program to support Windows Authentication, then follow the instructions for the advanced 
installation as described in Chapter 10, “Performing an Advanced Vibe Installation,” on page 119. 
Return here and continue with additional configuration steps. 


Configuring Your Browser to Allow Access to the Vibe Site 


After Windows Authentication has been enabled on the server, you need to configure the client 
browser to allow access to the Vibe site. 
* “Internet Explorer” on page 112 


* “Firefox” on page 113 


Internet Explorer 


1 In an Internet Explorer window, click Tools > Internet Options. 
The Internet Options dialog box is displayed. 

2 Click the Security tab, select Local intranet, then click Sites. 
The Local Intranet dialog box is displayed. 

3 Click Advanced. 
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4 Inthe Add this website to the zone field, specify the Vibe Web site. 
5 Click Add > Close. 


Firefox 


1 In Firefox, specify about: config in the URL field. 


2 Specify nt1m in the Filter window, then locate and select the network. automatic-ntlm- 
auth.trusted-uris entry. 


The Enter String Value dialog box is displayed. 
3 Specify the DNS name of your Vibe site, then click OK. 
For example, vibe.mycompany.com. 


4 Repeat Step 2 through Step 3 for network. negotiate-auth.trusted-uris and network.negotiate- 
auth.delegation-uris. 


9.10.6 Bypassing Windows Authentication to Configure LDAP and 
Perform Other Tasks 


After Windows Authentication is working on your Vibe server, you can bypass the Windows 
Authentication functionality by including the Vibe listening port in the Vibe URL. 


You need to do this in order to configure your LDAP directory. 


1 Ina Web browser, specify your Vibe URL with the Vibe listening port. 
For example, http: //vibe:8080. 
The Vibe login page is displayed. 


Novell. 


User ID 


Password 


2 Log in to the Vibe site as the Vibe administrator. 


3 Configure LDAP, as described in Section 5.3, “Adding Vibe Users from Your LDAP Directory,” on 
page 78. 


You might also need to bypass Windows Authentication to access Vibe for the following reasons: 


* To access a specific Vibe node in a clustered environment. 


¢ To troubleshoot the Vibe system. 


9.10.7 Logging In to the Vibe Site through Windows Authentication 


After you have performed the configuration steps described in Section 9.10.3, “Configuring the Vibe 
Server to Support Windows Authentication,” on page 106 through Section 9.10.5, “Configuring Your 
Browser to Allow Access to the Vibe Site,” on page 112, users can access the Vibe site through 
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Windows Authentication. Users who have been configured through LDAP and are already logged in 
to their individual workstations do not need to log in again to access the Vibe site. Users who are not 
already logged in before they access Vibe see the following dialog box: 


Authentication Required x| 


Q Enter username and password for http://13.6.7.31 


User Name: 


Password: |eeeeeesss 
cee | 


Editing Files through WebDAV with Windows 
Authentication 


* “Achieving Single Sign-On When Editing Files through WebDAV” on page 114 
¢ “Enabling Basic Authentication for WebDAV” on page 114 


Achieving Single Sign-On When Editing Files through WebDAV 


By default, when you edit a file in Vibe through WebDAV, you are prompted for your system login 
credentials before you can edit the file. However, when Windows Authentication is enabled on your 
Vibe server, you are no longer prompted for your system login credentials before you edit a file 
through WebDAV. 


This functionality is supported only when you use Microsoft Office as your default document editor. 
When you use OpenOffice 3.1 or later as your default document editor, Vibe allows you to edit files 
through WebDAV, but it still requires you to enter your system login credentials. The single sign-on 
experience is only available when you use Microsoft Office. 


Enabling Basic Authentication for WebDAV 


If you are using OpenOffice 3.0 or earlier, or any other document editor that requires basic 
authentication (it does not support Windows Authentication), you need to configure your IIS server to 
support basic authentication. Supporting basic authentication enables Vibe users to edit files through 
WebDAV when using a document editor other than Microsoft Office or OpenOffice 3.1 or later. 


NOTE: If you enable basic authentication on your IIS server, all users who access the Vibe site 
through Firefox are prompted for their login credentials. Single sign-on to the Vibe server no longer 
functions. However, users who access the Vibe site using Internet Explorer retain the single sign-on 
experience. 


To enable basic authentication on your IIS server, you need to install the Basic Authentication Role 
Service. 
1 On the Windows 2008 server, click Start > Administrative Tools > Server Manager. 
2 Expand Roles, then right-click Web Server (IIS). 
3 Click Add Role Services. 
The Add Role Services window is displayed. 
4 Scroll to the Security section, then select Basic Authentication. 


5 Click Next, then complete the installation. 
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9.10.10 


Click Start > Administrative Tools > Internet Information Services (IIS) Manager. 


7 Inthe Connections pane on the left side of the window, expand your server, expand Sites, then 


expand Default Web Site. 


8 Select VibeResources1, then double-click Authentication. 


9 Select Basic Authentication, then click Enable in the Actions panel. 


10 


Close the Internet Information Services (IIS) Manager. 


Configuring IIS to Allow Uploading of Large Files to the Vibe 
Site 


By default, IIS might not allow you to upload large files to the Vibe site. This is caused by timeout 
restrictions as well as maximum upload size restrictions. 


For information about how to configure IIS to allow you to upload large files, see article 925083 in the 
Microsoft Support Knowledgebase (http://support.microsoft.com/kb/925083). 


Configuring IIS to Load Balance in a Clustered Environment 


If you have Vibe installed in a clustered environment where there are multiple Vibe nodes, you can 
configure IIS to balance the load of user requests from the multiple Vibe nodes, while still supporting 
Windows Authentication. 


1 


On the IIS server, locate the c:\Program Files\Novell\Vibe IIS 
Plugin\conf\workers.properties.clustered.template file, then open the file in a text 
editor. 


2 Copy the contents of the file. 


3 Locate the c:\Program Files\Novell\Vibe IIS Plugin\conf\workers.properties file, 


then open the file in a text editor. 


Paste the contents of the c:\Program Files\Novell\Vibe IIS 
Plugin\conf\workers.properties.clustered.template that you copied in Step 2 and into 
the C:\Program Files\Novell\Vibe IIS Plugin\conf\workers. properties file, overwriting 
the content that was previously there. 


Replace the value of worker.worker1.host from first_hostname_or_ip with the hostname or IP 
address of your first Vibe node. 


Repeat Step 5 for each additional Vibe node that is running in your environment. If you have 
more than two Vibe nodes, you should add an additional section to the workers.properties file 
for each additional node. 


The values that you specify in the workers .properties file (for example, worker1, worker2, 

etc.) must exactly match the values that you specify as the JVM Route setting during the Vibe 

installation, as described in Section 15.2, “Installing the Vibe Software on Multiple Servers,” on 
page 140. 


Locate the c:\Program Files\Novell\Vibe IIS 
Plugin\resources1\conf\uriworkermap. properties file, then open the file in a text editor. 


8 Replace all instances of worker1 with balancer. 


9 Repeat Step 7 and Step 8 for each Vibe node. 
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Locate the c:\Program Files\Novell\Vibe IIS 
Plugin\resources2\conf\uriworkermap.properties file, then open the file in a text editor. 


Replace all instances of worker1 with balancer. 
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9.11 


9.11.1 


12 Repeat Step 10 and Step 11 for each Vibe node. 

13 Restart each Vibe node. 

14 Restart the IIS server: 
14a Click Start > Administrative Tools > Internet Information Services (IIS) Manager. 
14b Select your server in the Connections panel, then click Restart in the Actions panel. 


Configuring Mirrored Folder Resource Drivers 


A mirrored folder is a directory, either local or shared on a SAN (storage area network), that is directly 
accessible from the Novell Vibe site. The files on the file system are accessed by the Novell Vibe 
program through a resource driver, not directly by individual Vibe users. A resource driver defines 
how the Vibe program accesses the file system. 


During installation, you define the users and groups that can access the mirrored folder resource 
drivers. After installation, from the Vibe site, you associate resource drivers with specific Vibe folders 
and use folder access controls to govern which users and groups can access the data in the mirrored 
folder. As a result, you can set up a small number of users who can create mirrored folders, and allow 
a larger number of users to access the mirrored folders. 


Vibe attempts to keep the metadata about each mirrored folder synchronized with the contents of the 
actual file system. Therefore, mirrored folders are most appropriate for large sets of relatively static 
data. Mirrored folders are also useful for making extremely large files available from your Vibe site 
without including them in the Vibe file repository. 


Although the installation program allows you to set up three mirrored folder resource drivers during 
installation, you can set up and test just one to start with, then set up additional resource drivers later. 
* Section 9.11.1, “File System Type,” on page 116 
* Section 9.11.2, “File System Directory,” on page 117 
* Section 9.11.3, “File System Access,” on page 117 
* Section 9.11.4, “Mirrored Folder Setup,” on page 117 
After planning mirrored folders, complete the planning process for additional Advanced installation 


features as needed, then perform the Advanced installation as described in Chapter 10, “Performing 
an Advanced Vibe Installation,” on page 119. 


File System Type 


Vibe provides resource drivers for two different types of file systems: 


* file: A directory in a regular file system on a Linux or Windows server. 


+ webdav: A directory on a Web server that supports WebDAV (Web-based Distributed Authoring 
and Versioning). The WebDAV server must support HTTP Basic Authentication (http:// 
en.wikipedia.org/wiki/Basic_access_authentication) so that Vibe can provide a username anda 
password when making a request from the WebDAV server. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Mirrored Folder Resource Driver Configuration, mark the type of directory that you want to mirror 
in your Vibe site. 
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9.11.2 


9.11.3 


9.11.4 


File System Directory 


The file system that a Vibe mirrored folder uses can be on Linux, NetWare, or Windows, as long as 
the following conditions are met: 


* The file system is accessible from the Vibe server by using a directory path specification that the 
Vibe server operating system understands. 


+ The file system is accessible through the standard java.io package interface. 


IMPORTANT: On Windows, you must use forward slashes (/) in the pathname, not the typical 
Windows backslashes (\). For example, use c: /Documents rather than c:\Documents. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under Mirrored Folder Resource Driver Configuration, specify the full path for the directory that you want 
to mirror in your Vibe site. Also, provide a title for the mirrored folder resource driver that indicates what 
directory or data is being mirrored. For WebDAV mirrored folders, you must also specify the URL of the 

WebDAV host where the data is located. 


If you need to eventually set up more than three directories as mirrored folders in your Vibe site, you 
can edit the installer.xml file in the directory where you run the Installation program. 


File System Access 


Vibe offers several security options for controlling access to the data that resides on the file system. 
* You can restrict the Vibe program to read-only access to the mirrored data, or you can allow full 
read/write access. 


* You can list specific Vibe users who are allowed to access the mirrored folder resource drivers 
and thereby create mirrored folders. 


* You can list specific Vibe groups whose members are allowed to access the mirrored folder 
resource drivers and thereby create mirrored folders. 


+ For WebDAV mirrored folder resource drivers, you must also specify a username and password 
that the Vibe program can use to access the WebDAV server. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 
Under Mirrored Folder Resource Driver Configuration, list the file access (read/write or read-only) for the 


mirrored data, along with users and groups that you want to have access to the resource driver. For a 
WebDAV mirrored folder, list a username and password that provides access to the WebDAV server. 


Mirrored Folder Setup 


After you run the Vibe Installation program to configure the Vibe site for mirrored folder resource 
drivers, additional folder setup is required. Follow the instructions in “Setting Up Mirrored Folders” in 
“Site Setup” in the Novell Vibe 3.4 Administration Guide. 
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9.12 Installing the Vibe Software in a Clustered 
Environment 


You must use an Advanced installation in order to install the Novell Vibe software on multiple servers 
and set up a clustered environment. Setting up multiple Vibe servers, along with other clustering 
options, are described in Chapter 15, “Running Vibe on Multiple Servers,” on page 139. 
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Performing an Advanced Vibe 
Installation 


You should already have reviewed Chapter 3, “Planning a Basic Vibe Installation,” on page 35 and 
filled out the Basic Vibe Installation Summary Sheet. You should also have reviewed Chapter 9, 
“Planning an Advanced Vibe Installation,” on page 95 and filled out the Advanced Vibe Installation 
Summary Sheet for those aspects of an Advanced installation that you want to implement for your 
Novell Vibe site. 


1 Follow the Basic installation instructions provided in Chapter 4, “Installing and Setting Up a Basic 
Vibe Site,” on page 61 for the platform where you are installing Vibe. 


2 When you run the installation program, select Advanced on the Choose Installation Type page. 


Novell Vibe 3 Installation Program 


Choose Installation Type 


Select the type of installation you want to perform 


Basic | 


3 Use the information that you have gathered on the Basic Vibe Installation Summary Sheet and 
the Advanced Vibe Installation Summary Sheet to provide the information that the Vibe 
Installation program prompts you for: 


Select the Advanced installation if you want to configure any 
of the optional features. 


Basic Installation Pages: 


Installation Locations 

Location of TrueType Fonts for Stellent Converters 
Default Locale for Novell Vibe 

User ID for Novell Vibe (Linux only) 

Network Information 

WebDAV Authentication Method 

Database Selection 

Java JDK Location 

Outbound E-Mail Configuration 

Inbound E-Mail Configuration 


Some Basic installation pages have additional options available when you perform an Advanced 
installation. 


Advanced Installation Pages: 


Web Services 

Lucene Configuration 

RSS Configuration 

Presence Configuration 
Reverse Proxy Configuration 
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Integration with IIS for Windows Authentication 
Mirrored Folder Resource Driver Configuration 
Vibe Cluster Configuration 
The Installation program stores the information it gathers in the installer .xml file in the same 
directory where you started the Installation program. 
4 After you have provided all the requested information, click Install to begin the Advanced 
installation. 
5 When the installation is complete, click Finish to exit the Vibe installation program. 
Information about the installation process is written to the installer. log file in the same 


directory where you ran the Installation program. If a problem arises during the installation, the 
installer.log file provides information that can help you resolve the problem. 


6 After you complete the Advanced installation, continue setting up your Vibe site, as described in 
Chapter 5, “Adding Users to Your Vibe Site,” on page 75. 
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Setting Configuration Options after 
Installation 


After you install Novell Vibe, following the instructions in Part II, “Basic Installation,” on page 33 or 
Part III, “Advanced Installation and Reconfiguration,” on page 93, you can rerun the Vibe installation 
program to change configuration options or add new functionality to your Vibe site. 


1 Stop Vibe. 


2 Start the Vibe installation program as described in Section 4.1.2, “Running the Linux Vibe 
Installation Program,” on page 63 and Section 4.2.2, “Running the Windows Vibe Installation 
Program,” on page 71. 


Novell Vibe 3 Installation Program 


Installation Options 


Select the action you want to perform. 


C New installation 
© Update software and settings 
œ Reconfigure settings 


Because the Installation program finds an existing installer.xml file, it defaults to Reconfigure 
settings. 


3 Click Next. 
The Vibe Installation program asks you to verify that you have stopped Vibe. 
4 Click Yes. 


Novell Vibe 3 Installation Program 


Choose Installation Type 


Select the type of installation you want to perform 


Basic Select the Advanced installation if you want to configure any 
of the optional features. 


5 Select Basic or Advanced, depending on the configuration settings that you want to change, then 
click Next. 


6 Click Next until you reach an installation page where you want to reconfigure settings. 
Basic Installation Pages: 


Installation Locations 

Location of TrueType Fonts for Stellent Converters 
Default Locale for Novell Vibe 

User ID for Novell Vibe (Linux only) 

Network Information 

WebDAV Authentication Method 
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Database Selection 

Java JDK Location 

Outbound E-Mail Configuration 
Inbound E-Mail Configuration 


Advanced Installation Pages: 


Web Services 

Lucene Configuration 

RSS Configuration 

Presence Configuration 

Reverse Proxy Configuration 

Integration with IIS for Windows Authentication 
Mirrored Folder Resource Driver Configuration 
Vibe Cluster Configuration 


7 When you reach the Ready to Install page, click Install to implement the reconfigured settings. 
8 Start Vibe. 
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Advanced Vibe Installation Summary 


Sheet 


Installation Program Field 


Data Locations: 
Linux default: 
/var/opt/novell/teaming 
Windows default: 
c:\Novell\Teaming 

* Simple file repository 

* Jackrabbit repository 

* Extensions repository 


* Cache store 


* Lucene index 


Value for Your Vibe Site Explanation 


See Section 9.2, “Distributing 
Different Data Types to Different 
Locations,” on page 96. 


Network Information: 
* Enable Web services: 


No / Yes 
* Session timeout 


Default: 240 minutes 


* Enable Tomcat access log: 


No / Yes 


+ Keystore file: 


See Section 9.3, “Using Advanced 
Network Information Settings,” on 
page 97. 


Network Information: 


* Max Threads 


Default: 200 
+ Max Active 

Default: 50 
* Max Idle 


Default: 20 


See Section 9.4, “Configuring 
Requests and Connections 
Configuration,” on page 98. 


WebDAV Authentication Method 


* basic 


* digest 


See Section 3.5, “Planning the 
WebDAV Authentication Method,” 
on page 42. 
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Installation Program Field Value for Your Vibe Site 


Web Services: 


* Enable WSS authentication 
* Enable Basic authentication 


* Enable token-based 
authentication 


* Enable anonymous access 


Explanation 


See Section 9.5, “Configuring Web 
Services,” on page 99. 


Lucene Configuration: 
Configuration type: all 
* Max booleans: 


Default: 10000 
+ Merge factor: 
10 


See Section 9.6.2, “Changing 
Lucene Configuration Settings,” on 
page 100. 


Server Lucene Configuration: 
Configuration type: server only 


* Host: 
* RMI port: 
Default: 1199 


See Section 9.6.3, “Running the 
Lucene Index Server in Its Own 
JVM,” on page 100. 


High Availability Lucene 
Configuration: 


Configuration type: high availability 
only 


Number of high availability search 
nodes: 


* Service name: 
* Service title: 
* Host: 


* RMI port: 


* Service name: 
* Service title: 
* Host: 


* RMI port: 


See Chapter 16, “Running Multiple 
Lucene Index Servers,” on 
page 147. 


RSS Configuration: 
Enable RSS: No / Yes 


* Max elapsed days: 


+ Max inactive days: 
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See Section 9.7, “Managing RSS 
Feeds,” on page 101. 


Installation Program Field Value for Your Vibe Site 


Presence Configuration: 
Enable presence: No / Yes 


* Server address: 
* Port: 

+ Server user: 

* Password: 


* Server Certificate: 


Explanation 


See Section 9.8, “Configuring 
Presence,” on page 102. 


Reverse Proxy Configuration: 
Enable Access Gateway: No / Yes 


* Access Gateway address(es): 
* Logout URL: 


* Use Access Gateway for 
WebDav connections: No / Yes 


* WebDAV Access Gateway 
address: 


Integration with IIS for Windows 
Authentication: 


Enable Integration with IIS for 
Windows Authentication: No / Yes 


¢ IIS address(es): 


* Logout URL: 


Mirrored Folder Resource Driver 
Configuration: 


Enable file share: No / Yes 


* Share type 
* File 
* WebDav 
* Readonly: No/ Yes 
* Title 
* Root path 
* Allowed users 
* Allowed groups 
* User 
* Password 


* Host URL 


See Section 9.9, “Configuring 
Single Sign-On with Novell Access 
Manager,” on page 103. 


See Section 9.10, “Configuring 
Single Sign-On with Internet 
Information Services for Windows,” 
on page 103. 


See Section 9.11, “Configuring 
Mirrored Folder Resource Drivers,” 
on page 116. 
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Multi-Server Configurations and 
Clustering 


* Chapter 13, “Creating the Vibe Database on a Remote Server,” on page 129 

* Chapter 14, “Installing the Lucene Index Server on a Remote Server,” on page 135 
* Chapter 15, “Running Vibe on Multiple Servers,” on page 139 

* Chapter 16, “Running Multiple Lucene Index Servers,” on page 147 

* Chapter 17, “Running Multiple Database Servers,” on page 165 
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13.1 


Creating the Vibe Database on a Remote 
Server 


The default database location for Novell Vibe is on the same server with the Vibe software, as 
described in Section 3.6.3, “Database Location,” on page 45. However, for better performance and 
scalability, you can install the database server (MySQL, Microsoft SQL, or Oracle) on a remote 
server, then use the scripts that are included with the Vibe software to manually create the Vibe 
database in any location that you prefer. 

* Section 13.1, “Preparing to Manually Create a Database,” on page 129 

* Section 13.2, “Creating a MySQL Database,” on page 130 

¢ Section 13.3, “Creating a Microsoft SQL Database,” on page 131 

* Section 13.4, “Creating an Oracle Database,” on page 132 

* Section 13.5, “Installing Vibe with a Remote Database,” on page 133 


NOTE: This section assumes that you already have a Basic installation of Vibe up and running 
successfully. We highly recommend that you follow the instructions in Part II, “Basic Installation,” on 
page 33 before attempting a more complex Vibe configuration. 


Preparing to Manually Create a Database 


Novell Vibe includes scripts for creating the Vibe database on a remote server. 
1 Copy the teaming-3.1.n-sql.zip file from the Vibe server where the Vibe installation program 
is located and copy it to the database server. 
or 
Download and unzip the Vibe software onto the database server. 


2 In the directory where the Vibe Installation program is located on the database server, or in the 
location where you copied the teaming-3.1.n-sql.zip file, unzip the teaming-3.1.n-sql.zip 
file. 


This creates two new subdirectories, the create subdirectory for database creation scripts and 
the update-3.0.n-3.1.n directory for database update scripts. 


3 Change to the create subdirectory. 


4 Copy all the scripts for your database type to a convenient temporary location on the server 
where you want to create the database, and make sure that your database management utility is 
on your path so that you can run it from that directory 


Database Database Script Database Management Utility 
MySQL *mysql.sql mysql 

Microsoft SQL *sqlserver.sql osql 

Oracle *oracle.sql sqlplus 
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5 Continue with the instructions for the type of database that you want to create: 
* Section 13.2, “Creating a MySQL Database,” on page 130 
* Section 13.3, “Creating a Microsoft SQL Database,” on page 131 


* Section 13.4, “Creating an Oracle Database,” on page 132 


13.2 Creating a MySQL Database 


Before you begin, you should be familiar with standard database maintenance procedures. 
For more information about MySQL, see the following references: 


¢ MySQL 5.0 Reference Manual (http://dev.mysql.com/doc/refman/5.0/en) 
* MySQL 5.1 Reference Manual (http://dev.mysql.com/doc/refman/5.1/en) 


The following database tools can be helpful: 


* MySQL GUI Tools (http://dev.mysql.com/downloads/gui-tools) 

¢ SQLyog (http://www.webyog.com) 

* Squirrel SQL Client (http://squirrel-sql.sourceforge.net) 

1 Review the MySQL requirements listed in Section 2.2, “Vibe 3.4 Server Requirements,” on 
page 20. 


2 Make sure that the MySQL database server and client have been installed and configured, as 
described in Section B.2, “MySQL Database Server,” on page 228. 


3 Make sure that the MySQL database client is also installed on the Vibe server. 


The Vibe installation program needs the MySQL client in order to communicate with the remote 
MySQL database server. 


A 


Make sure that you know the password for the MySQL root administrator user. 


ol 


Make sure that innodb support is enabled. 
It is enabled by default. To verify that innodb support is enabled: 


5a Enter the following command to access the MySQL monitor: 
mysql -u root -p 


For information on how to set a password for your MySQL database if you have not already 
done so, see “Configuring MySQL” on page 228. 


5b Specify your password. 


5c From the MySQL prompt, enter the following command to display status information about 
the server’s storage engines: 


SHOW ENGINES\G 


5d Locate the InnoDB engine, and ensure that innodb support is enabled. 
6 Update the MySQL configuration file: 
6a Locate the MySQL configuration file and open it in a text editor. 


Linux: /etc/my.cnf 


Windows: c:\Program Files\MySQL\MySQL Server version\my.ini 
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6b Under the [client] section, add the following line: 


default character set = utf8 


6c Under the [mysqld] section, add the following line: 


character set server = utf8 


Setting the character set to UTF-8 ensures that extended characters are handled correctly 
in the database. 


6d (Conditional) For a system with multiple network interfaces, in the [mysqld] section, add 
the following line: 


bind-address = mysgl server address 


Replace mysql server address with the IP address that you want MySQL to bind to and 
to listen on. 


6e Save the updated configuration file, then exit the text editor. 
7 In the directory where you copied the database scripts (Step 4 in Section 13.1, “Preparing to 
Manually Create a Database,” on page 129), enter the following command to run the MySQL 
database creation script: 


mysql -uuser -ppassword < create-database-mysql.sql 


8 Configure MySQL to allow access from a remote server: 


mysql -uuser -ppassword 

mysql> grant all privileges on *.* 
-> to 'username'@'%' 
-> identified by 'password' 
-> with grant option 
E 


9 Skip to Section 13.5, “Installing Vibe with a Remote Database,” on page 133. 


Creating a Microsoft SQL Database 


Before you begin, you should be familiar with standard database maintenance procedures. 
For more information about Microsoft SQL, see the following references: 


* Microsoft SQL Server 2008 Learning Resources (http://www.microsoft.com/sqlserver/2008/en/ 
us/learning.aspx) 


* Microsoft SQL Server 2005 Learning Resources (http://www.microsoft.com/sqlserver/2005/en/ 
us/learning-resources.aspx) 


The following database tool can be helpful: 
* Squirrel SQL Client (http://squirrel-sql.sourceforge.net) 
To create a Microsoft SQL database: 


1 Review the Microsoft SQL requirements listed in Section 2.2, “Vibe 3.4 Server Requirements,” 
on page 20. 


2 Make sure that the Microsoft SQL Server and Client have been installed and configured properly. 


IMPORTANT: Make sure that TCP/IP is enabled for the Microsoft SQL Server. 
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For more information, see “Microsoft SQL Server” (http://msdn.microsoft.com/en-us/library/ 
bb545450.aspx). 


3 Make sure that the Microsoft SQL database client is also installed on the Vibe server. 


The Vibe installation program needs the Microsoft SQL client in order to communicate with the 
remote Microsoft SQL database server. 


4 When you install Microsoft SQL Server, select SQL Server and Windows for authentication. 
The default is Windows Only, which is not appropriate for Vibe. 


5 Immediately establish the database administrator username and password for the SQL database 
server. 


6 Change to the directory where you copied the database scripts in Step 4 in Section 13.1, 
“Preparing to Manually Create a Database,” on page 129. 


7 Enterthe following command to run the Microsoft SQL database creation script: 
osql -Uuser -Ppassword -i create-database-sqlserver.sql 


8 Skip to Section 13.5, “Installing Vibe with a Remote Database,” on page 133. 


Creating an Oracle Database 


When you use an Oracle database, your database administrator must create it for you. The Novell 
Vibe installation program cannot create an Oracle database. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Creation, make sure you have marked that you want your database administrator to 
manually create the Oracle database before installation. 


Before you begin, you should be familiar with standard database maintenance procedures. 
For more information about your Oracle database, see the following references: 


* Oracle Product Documentation (http://www.oracle.com/technetwork/indexes/documentation/) 

* Oracle SQL Plus Documentation (http://download.oracle.com/docs/cd/B19306_01/server.102/ 
b14357/toc.htm) 

The following database tool can be helpful: 

* Squirrel SQL Client (http://squirrel-sql.sourceforge.net) 

1 Review the Oracle database requirements listed in Section 2.2, “Vibe 3.4 Server Requirements,” 
on page 20. 

2 Make sure that the Oracle database server software has been installed and configured properly. 
For more information, see Oracle Database (http://www.oracle.com/database). 

3 Setup the Oracle database character set to support Unicode character encodings. 


Vibe requires either the UTF-8 or AL32UTF8 character set for proper operation. Oracle 
recommends AL32UTF8, because it has increased support for certain Asian languages. For 
more information, see “Choosing a Character Set” (http://download.oracle.com/docs/cd/ 
B19306_01/server.102/b14225/ch2charset.htm) in the Oracle Database Globalization Support 
Guide. 


4 Change to the directory where you copied the Oracle database scripts in Step 4 in Section 13.1, 
“Preparing to Manually Create a Database,” on page 129. 
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5 Edit the create-database-oracle.sql script with your Oracle database password. 
Original: 


drop user sitescape cascade; 

create user sitescape identified by sitescape; 
grant connect, resource to sitescape; 

connect sitescape/sitescape; 


SiteScape is the name of the company that previously owned the Vibe software. 
Updated: 


drop user sitescape cascade; 

create user sitescape identified by your oracle password; 
grant connect, resource to sitescape; 

connect sitescape/your oracle password; 


IMPORTANT: Unless you are very familiar with editing scripts, change only the password. Do 
not attempt to change the name of the database from the legacy default of sitescape. 


6 Enter the following commands to run the database creation script: 


sqlplus "/ as sysdba" 

SQL> spool create-database-oracle.out; 
SQL> @create-database-oracle; 

SQL> quit 


7 Check the resulting create-database-oracle. out file for errors and resolve them. 


8 If you created the Oracle database on the Vibe server, skip to Chapter 4, “Installing and Setting 
Up a Basic Vibe Site,” on page 61 or Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


IMPORTANT: On the Database Selection page in the Installation program, be sure to select 
Database already exists or has already been created. 


or 


If you created the Oracle database on a remote server, continue with Installing Vibe with a 
Remote Database. 


13.5 Installing Vibe with a Remote Database 


1 Run the Novell Vibe installation program, as described in Chapter 4, “Installing and Setting Upa 
Basic Vibe Site,” on page 61 or Chapter 10, “Performing an Advanced Vibe Installation,” on 
page 119. 


2 Fill in the fields on the Database Selection page: 
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Novell Vibe 3 Installation Program 


Database Selection 


Select your database and set the database options. 


The database server you select must already be installed. 


Database type: [MySql x| 


JDBC URL: \jdbc:mysql:/localhost:3306/sitescape?useUnicode=true&characterEncoc 


rCredentials 


Usemame: root 


Password: 


Setup — 
C Create the database during installation 
‘* Database already exists or has already been created 


rEneryption algorithm 


User passwords are encrypted using the selected algorithm: 


Gao T 


Database type: Select the type of database that you just created. 


JDBC URL: Replace localhost, with the hostname of the server where you created the Vibe 
database. If needed, replace the port number with the port that Vibe uses to communicate with 
the database, and replace the database name with the name of your database. 


Credentials: Specify the password for the database administrator user. 


Setup: Select Database already exists or has already been created so that the installation 
program does not create one for you. 


Encryption algorithm: Set the encryption appropriate for the security needs of the Vibe site. 
For more information, see Section 3.6.5, “Database Encryption Algorithm,” on page 46. 


Click Next. 


The Vibe installation program tries to connect to the database. If it connects successfully, you 
can continue with the installation. If the Vibe installation program cannot connect to the 
database, you must resolve the problem with the database before you can continue with the Vibe 
installation. 


4 When the Vibe installation program can successfully connect to the remote database, continue 


as usual with the installation. 
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Installing the Lucene Index Server ona 
Remote Server 


You can install the Lucene Index Server on a different server from where Novell Vibe is running. If the 
Lucene Index Server is already running on the same server as Vibe, you can move the Lucene Index 
Server to a different server. 


Running the Lucene Index Server on a remote server allows both the Lucene Index Server and the 
Vibe server to have access to more server memory, disk space, and CPU resources. 


Complete the following sections whether you are installing the Lucene Index Server on a remote 
server, or moving the Lucene Index Server to a remote server. 


IMPORTANT: The Vibe server and the Lucene Index Server must not have a firewall between them. 
The RMI protocol used for the Lucene Index Server port works only within a trusted local area 
network (LAN). 


* Section 14.1, “Installing the Lucene Software,” on page 135 
* Section 14.2, “Updating Your Vibe Site,” on page 137 
* Section 14.3, “Managing a Remote Lucene Index Server,” on page 137 


NOTE: This section assumes that you already have a Basic installation of Vibe up and running 
successfully. We highly recommend that you follow the instructions in Part II, “Basic Installation,” on 
page 33 before attempting a more complex Vibe configuration. 


14.1 Installing the Lucene Software 


1 Make sure that the Java Developer Kit (JDK) is installed on the remote server where you want to 
install the Lucene Index Server. 


You must use the same JDK that is being used on the server where Vibe is running. For 
example, if you are using the IBM JDK on the server where Vibe is running, you must use the 
IBM JDK on the remote Lucene Index Server. 


For instructions, see Appendix B, “Vibe 3.4 System Requirements Assistance,” on page 225. 
2 Make sure that there is no firewall between the Vibe server and the Lucene Index Server. 


3 Copy the Lucene installation program from its original location in the same directory with the 
Vibe installation program to a convenient temporary directory on the remote server. 


The filename for the Lucene Installation program varies by platform: 


Linux: lucene-installer.linux 


Windows: lucene-installer.exe 


4 Change to the directory where you copied the Lucene installation program, then start it. 


5 Accept the License Agreement, then click Next. 
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6 Select New installation, then click Next. 


7 Browse to and select the directory where you want to install the Lucene Index Server, then click 
Next. 


The default location varies by platform: 


Linux: /opt/novell/teaming/luceneserver 


Windows: c:\Program Files\Novell\Teaming\luceneserver 


8 Browse to and select the directory where you installed the JDK, then click Next. 


9 Adjust the configuration of the Lucene Index Server, as described in Section 9.6, “Changing Your 
Lucene Index Server Configuration,” on page 99, then click Next. 


10 Click Install to install the Lucene software. 
11 (Conditional) On Linux, deselect Start Lucene server. 


You must edit the Lucene Index Server startup script before you start the Lucene Index Server. 
Instructions are provided later in this procedure. 


12 (Conditional) On Windows, if you do not want to start the Lucene Index Server immediately, 
deselect Start Lucene server. 


For instructions for starting and stopping the Lucene Index Server manually, see Section 14.3, 
“Managing a Remote Lucene Index Server,” on page 137. 


13 Click Finish. 
14 (Conditional) On Linux: 
14a Change to the following directory: 


/opt/novell/teaming/luceneserver/indexserver/bin 


14b Open the indexserver-startup.sh file in a text editor. 
14c Add the following switch to the java launch command at the end of the script: 


-Djava.rmi.server.hostname=ip address 


Rename ip address with the IP address of the server where you installed the Lucene 
Index Server. 


14d Save the indexserver-startup. sh file, then exit the text editor. 
14e Start the Lucene Index Server. 


For instructions for starting and stopping the Lucene Index Server manually, see 
Section 14.3, “Managing a Remote Lucene Index Server,” on page 137. 


Moving the Lucene Index Server from the Vibe server to a remote server increases the scalability of 
your Vibe system because the workload is distributed between two different physical servers. 
However, in this configuration, the Lucene Index Server still runs on a single server. Your Vibe site 
depends on the Lucene Index Server for full functionality. If that server goes down for some reason, 
the Vibe site becomes inaccessible until access to the Lucene Index Server is restored. You can 
further expand your Vibe system by setting up multiple Lucene Index Servers to provide high 
availability, as described in Chapter 16, “Running Multiple Lucene Index Servers,” on page 147. 
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14.2 Updating Your Vibe Site 


Complete this section only if you are moving the Lucene Index Server. If you are performing a fresh 
Lucene Index Server installation, disregard this section. 

1 Stop Novell Vibe. 

2 Start the Vibe installation program to reconfigure the Lucene Index Server settings. 


For information on how to start the installation program, see Section 4.1.2, “Running the Linux 
Vibe Installation Program,” on page 63 or Section 4.2.2, “Running the Windows Vibe Installation 
Program,” on page 71. 


3 On the Choose Installation Type page, select Advanced, then click Next. 


4 Click Next until you reach the Lucene Configuration page. 
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Lucene Configuration 


Use the following fields to configure the Lucene index. 


To run the Lucene index as a server, select Server from the drop-down list. 
You can run Lucene as a server on the same machine where the Vibe software is installed or on a 
remote machine. 


Enter the host name and edit the RMI port if the default port cannot be used. 


Max booleans 10000 


Merge factor 10 
Lucene configuration type: local yj 


5 In the Lucene configuration type field, select server to activate additional fields. 
Host: Specify the hostname of the server where you installed the Lucene Index Server software. 


RMI Port: Use the same port number that you used when you installed the Lucene Index Server 
software. The default RMI port is 1199. 


6 Click Next until you reach the Ready to Install page, then click Install. 
7 When the installation is complete, click Finish. 
8 Start Vibe. 


14.3 Managing a Remote Lucene Index Server 


¢ Section 14.3.1, “Linux: Managing a Remote Lucene Index Server,” on page 137 


* Section 14.3.2, “Windows: Managing a Remote Lucene Index Server,” on page 138 


14.3.1 Linux: Managing a Remote Lucene Index Server 


Use the following commands to start and stop the Lucene Index Server manually: 


/etc/init.d/indexserver start 
/etc/init.d/indexserver stop 


To configure the Lucene Index Server to start automatically when the Linux server reboots, use: 


chkconfig --add indexserver 
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Windows: Managing a Remote Lucene Index Server 


Use the following commands at a DOS command prompt to start and stop the Lucene Index Server 
manually: 


c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin\ 


indexserver-startup.bat 


c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin\ 


indexserver-shutdown.bat 


To configure the Lucene Index Server to start automatically when the Windows server reboots, you 
can set it up as a scheduled task that runs at system startup. 


1 


on OO A 


On the Windows server where the Lucene Index Server is installed, click Start > All Programs > 
Accessories > System Tools > Scheduled Tasks. 


Double-click Add Scheduled Task. to open the Scheduled Task Wizard, then click Next to 
continue. 


Click Browse, then browse to and double-click the indexserver-startup.bat file in the 
following directory: 

c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin 

In the Task name field, specify an informative name for the task, such as Lucene Index Server. 
The default task name is the name of the batch file. 

In the Perform this task field, select When my computer starts, then click Next. 

Specify and confirm the Administrator password for the Windows server, then click Next. 
Select Open advanced properties for this task when | click Finish, then click Finish. 

Verify that Run only if logged on is deselected, then click OK. 


A new task with the name you specified in Step 4 is added to the list in the Scheduled Tasks 
window. 


Click File > Exit to close the Scheduled Task Wizard. 
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D Running Vibe on Multiple Servers 


By running Novell Vibe on multiple servers, you can achieve high availability, including failover and 
load balancing, depending on how you configure your servers. You must perform an Advanced 
installation on each server in order to configure the Vibe software for such a clustered environment. 
* Section 15.1, “Planning a Multi-Server Vibe Configuration,” on page 139 
* Section 15.2, “Installing the Vibe Software on Multiple Servers,” on page 140 


* Section 15.3, “Configuring a Web Application to Provide High Availability Functionality for Your 
Vibe Site,” on page 142 


* Section 15.4, “Configuring Internet Information Services to Support Multiple Vibe Servers,” on 
page 145 


NOTE: This section assumes that you already have a Basic installation of Vibe up and running 
successfully. We highly recommended that you follow the instructions in Part II, “Basic Installation,” 
on page 33 before attempting a more complex Vibe configuration. 


15.1 Planning a Multi-Server Vibe Configuration 


* Section 15.1.1, “Lucene Index Server Considerations,” on page 139 
* Section 15.1.2, “Vibe File Repository Considerations,” on page 139 
* Section 15.1.3, “Configuring Routing for Multicast IP on the Vibe Server,” on page 140 


15.1.1 Lucene Index Server Considerations 


Before you can implement a multi-server Novell Vibe configuration, you must move your Lucene 
Index Server away from the initial Vibe server, as described in Chapter 14, “Installing the Lucene 
Index Server on a Remote Server,” on page 135. 


15.1.2 Vibe File Repository Considerations 


Before you implement a multi-server Novell Vibe configuration, you must plan the Vibe file repository 
for the clustered Vibe servers. Your configuration must comply with the following restrictions: 


+ The Vibe file repository must be placed in a shared location that is accessible to each Tomcat 
instance. 


* All Tomcat instances must be configured with the same path leading to the shared storage. 


For background information on the contents of the Vibe file repository, see Section 9.2, “Distributing 
Different Data Types to Different Locations,” on page 96. 
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15.1.3 


15.2 
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Configuring Routing for Multicast IP on the Vibe Server 


If you are planning to use ehcache as your hibernate caching provider, you might need to set up the 
routing for multicast IP on each server where Vibe is installed. If this is not done, then depending on 
your Vibe system, you might see a communication error when you start the Vibe server. For example, 
in the log file you might see the following: 


Error starting heartbeat. Error was: No such device. 


To prevent this error, or to fix the Vibe system after the error occurs: 


1 Run the following command: 


route add -net 232.0.0.0/8 dev eth0 


Installing the Vibe Software on Multiple Servers 


1 Update your existing Novell Vibe server to participate in a multi-server configuration: 


la 
1b 


1c 
1d 
1e 

1 


-h 


1g 


1h 


i 


Stop Vibe. 
Start the Vibe Installation program. 


For information on how to start the installation program, see Section 4.1.2, “Running the 
Linux Vibe Installation Program,” on page 63 or Section 4.2.2, “Running the Windows Vibe 
Installation Program,” on page 71. 


On the Installation Settings page, select Reconfigure Settings, then click Next. 
On the Choose Installation Type page, select Advanced, then click Next. 
Click Next to proceed through the installation pages where no changes are needed. 


(Conditional) If you do not have the Basic Vibe Installation Summary Sheet and Advanced 
Vibe Installation Summary Sheet from the initial Vibe server installation, record the 
configuration of the initial Vibe server as you proceed through the installation pages. 


Subsequent Vibe servers in the multi-server configuration must be installed with the same 
configuration settings as the initial Vibe server. 


On the Vibe Cluster Configuration page, select Enable clustered environment to enable 
clustering. 


On the first Vibe node, in the JVM Route field, specify worker1. On the second Vibe node, 
in the JVM Route field, specify worker2, and so forth for each Vibe node, incrementing the 
JVM Route setting. Each tomcat instance should have a unique JVM Route setting. 


worker1, worker2, and so forth are the default names for the matching values used for the 
reverse proxy configuration. For example, if you have set up Apache or IIS as a reverse 
proxy, these are the default values. The JVM Route setting in the Vibe installer must match 
these values. 


Select one of the following options for your hibernate caching provider: 


ehcache: Ehcache is recommended for small clustered Vibe sites, and is included in the 
Vibe software. If you select this option, no further configuration is necessary. For more 
information, see Ehcache (http://ehcache.sourceforge.net). 


memcached: Memcached is recommended for medium to large clustered Vibe sites. 
Memcached is not included in the Vibe software. If you select this option, you must 
download and install memcached on each server that you plan to use for caching in your 
Vibe cluster. For information about downloading and installing memcached, see 
Appendix C, “Memcached Caching with Novell Vibe,” on page 231. 
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Depending on the cache provider you select, different options are displayed. 
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Vibe Cluster Configuration 


Select the checkbox to configure this Vibe installation to participate in a cluster. N 


M Enable clustered environment 


JVM Route: 


Hibernate caching provider: lehcache Mi 


Network interface for distributed cache service (Optional: IP address or hostname expected) 
HostName: | 


Multicast Group Address (Ip Address): |232.0.0.1 


Multicast Group Port: |4446 
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Vibe Cluster Configuration 


Select the checkbox to configure this Vibe installation to participate in a cluster. N 


M Enable clustered environment 


JVM Route: 


Hibernate caching provider: memcached Mi 


Enter a space delimited list of memcached instances in the format host: port 
For example, 192.168.1.5:11211 192.168.1.7:11212 


Server Addresses: 


1j (Conditional) If you selected ehcache as the hibernate caching provider in Step 19, specify 
the following information on the Vibe Cluster Configuration page to configure ehcache: 


Network interface for distributed cache service: Specify the IP address or hostname of 
the distributed cache service. 


Multicast Group Address: (Optional) Specify the common multicast group IP address. 
Each clustered node recognizes other nodes in the cluster by means of this IP address. 


IMPORTANT: Make sure you specify the same IP address on all Vibe nodes in the cluster. 
After you have set this IP address for each Vibe node, restart each node in succession, 
allowing each node to initialize before restarting the next. 


The default multicast group IP address is 232.0.0.1. If you have more than one clustered 
Vibe system (for example, one in the lab and one in production), or if you have another 
software product that is already using the default multicast group IP address, you must 
update this field for one system so that it uses an IP address other than the default. 


Use an IP address in the range of 224.0.0.1 to 239.255.255.255. 


Multicast Group Port: (Optional) Specify the port number through which the Vibe nodes 
will communicate. 
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1k (Conditional) If you selected memcached as the hibernate caching provider in Step 1g, 


specify the following information on the Vibe Cluster Configuration page to configure 
memcached: 


Server Addresses: Specify a list of memcached servers, with each server separated by a 
space. For example, hostname1:port hostname2:port hostname3:port 


The server addresses listed here are all nodes within the Vibe cluster. Changes made to 
one Vibe node are immediately visible in other Vibe nodes. Ensure that the clock settings 
for each Vibe node are synchronized. Failure to do so can significantly degrade overall 
system performance. 


Memcached is not included in the Vibe software. If you select memcached as your 
hibernate caching provider, you must download and install memcached on each server in 
your Vibe cluster. For information about downloading and installing memcached, see 
Appendix C, “Memcached Caching with Novell Vibe,” on page 231. 


11 On the Ready to Install page, click Install. 
1m On the Installation Complete page, click Finish. 


2 Install the Vibe software on each additional server, using the same installation settings that you 
used for the initial Vibe server. 


3 (Conditional) If you set up ehcache as the caching provider, on each Linux server where you 
installed the Vibe software, set the multicast route to enable the servers to function as a cluster: 


3a Use the following command on the command line to immediately set the multicast route for 


the server: 


route add -net 232.0.0.0/8 dev eth0 


3b To run this command each time the server reboots, add the command to the following file on 


each server: 


/etc/init.d/boot.local 


4 Start Vibe on each server, as described for the platform where you are installing Vibe: 
* Section 4.1.7, “Starting Vibe on Linux,” on page 68 
* Section 4.2.4, “Running Vibe as a Windows Service,” on page 73 
* Section 4.2.5, “Running Vibe as a Windows Application,” on page 74 


5 (Conditional) If you set up ehcache as the caching provider and the Vibe servers fail to start 
because of a communication error, ensure that you have followed the steps in Section 15.1.3, 
“Configuring Routing for Multicast IP on the Vibe Server,” on page 140. 


6 Continue with Configuring a Web Application to Provide High Availability Functionality for Your 
Vibe Site. 


Configuring a Web Application to Provide High 
Availability Functionality for Your Vibe Site 


After Novell Vibe is installed and running on multiple servers, you must provide additional software to 
provide high availability functionality. Because Vibe is based on Tomcat, you can use software that 
provides high availability for Tomcat. 


1 Install and configure one of the following Web applications to provide high availability for your 
Vibe site: 
* Apache Web server (http://www.apache.org) 


* Linux Virtual Server (http://www. linuxvirtualserver.org) 
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+ Novell Access Manager (https://www.netiq.com/products/access-manager/) 
* Microsoft Internet Information Services (http://www.iis.net) 


2 Configure the Web application to establish the Vibe site URL, which then stays constant for Vibe 
users regardless of which Vibe server they access at any given time. 


3 Start the Web application with its new configuration settings. 
4 Test your Vibe site for high availability. 


+ Ifyou are using Apache Web server, Linux Virtual Services, or Microsoft Internet Information 
Services, users can immediately log in to the Vibe site again after a failover has occurred. 
The connection between the user’s browser and the Vibe site is maintained as the failover 
occurs. 


+ If you are using Novell Access Manager, users must start a new browser session, then log 
in to the Vibe site after a failover has occurred. They cannot log in again from the same 
browser session because the connection between the user’s browser and the Vibe site 
must be reestablished after the failover. 


The following sections provide examples of how to configure the Web applications: 


¢ Section 15.3.1, “Configuring Apache as a Load Balancer,” on page 143 
¢ Section 15.3.2, “Configuring Linux Virtual Server as a Load Balancer,” on page 145 


Configuring Apache as a Load Balancer 


The following example configuration uses the balancer module built into the newer Apache (version 
2.2.4 and later) Web server. It is based on a widely used sticky session technique. Novell Vibe does 
not support session sharing/replication among Tomcat instances. 


If you are using Novell Access Manager as described in Section 9.9, “Configuring Single Sign-On 
with Novell Access Manager,” on page 103, you do not need to configure Apache to load balance as 
described in this section, because Access Manager provides this service. 


NOTE: When you update your Vibe system, these settings are not preserved. You must redefine 
these settings each time you update your Vibe system. 


To configure Apache to load balance: 


1 Install the Apache Web server (http://httpd.apache.org) on one server. 
2 Edit the /etc/sysconfig/apachez? file: 
2a Locate the following line: 
APACHE MODULES= 


Then add the following lines: 


proxy 
proxy_ajp 
proxy _balancer 


The end result should look similar to the following: 


APACHE MODULES="actions alias auth_basic authn_file authz_host 

authz groupfile authz default authz user authn dbm autoindex cgi dir env 
expires include log_config mime negotiation setenvif ssl suexec userdir 
php5 regtimeout proxy proxy ajp proxy balancer" 


2b Create the following new configuration file: 
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/etc/apache2/httpd.conf.vibe 


2c Add the following section to the /etc/apache2/httpd.conf.vibe file, providing a 
BalancerMember line for each jvmRoute value in a Tomcat server .xml file. 


<Location /balancer-manager> 
SetHandler balancer-manager 
Order deny, allow 
Deny from all 
Allow from 127.0.0.1 
</Location> 
<Proxy balancer://cluster_name> 
BalancerMember ajp://vibe server 1:8009 route=workerl 
BalancerMember ajp://vibe server 2:8009 route=worker2 
</Proxy> 
<Location /> 
ProxyPass balancer://cluster name/ stickysession=JSESSIONID 
</Location> 


The values that you specify for the route setting (for example, worker1, worker2, etc.) 
must exactly match the values that you specify as the JVM Route setting during the Vibe 
installation, as described in Section 15.2, “Installing the Vibe Software on Multiple Servers,” 
on page 140. 


2d Save the httpd.conf .vibe file. 


3 Reconfigure each Vibe server in the cluster so that each server has the same network 
information (hostname and ports) as the Apache Web server. 


For each Vibe server in the cluster: 
3a Run the Vibe installation program by reconfiguring the Vibe server. 


For information about how to reconfigure your Vibe server, see Chapter 11, “Setting 
Configuration Options after Installation,” on page 121. 


3b On the Network Information page in the Vibe installation program, change the hostname in 
the Host field for each Vibe server. The hostname must match the DNS name that users 
use to access the Vibe service. 


For example, if the URL for you Vibe site is vibe.acme.com, you would specify 
vibe.acme.com in this field. 


3c Continue through the Vibe installation program for each Vibe server in the cluster, as 
described in Chapter 11, “Setting Configuration Options after Installation,” on page 121. 


4 Restart Apache. 


TIP: For enhanced performance when using the Internet Explorer browser to access a Vibe system 
that is using Apache as an SSL reverse-proxy server, change the Apache SSL exclusion regular 
expression configuration from the following: 


SetEnvIf User-Agent ".*MSIE.*" \ 
nokeepalive ssl-unclean-shutdown \ 
downgrade-1.0 force-response-1.0 


to the following: 


SetEnvIf User-Agent ".*MSIE [1-5].*" 
nokeepalive ssl-unclean-shutdown 
downgrade-1.0 force-response-1.0 


SetEnvIf User-Agent ".*MSIE [6-9].*" 
ssl-unclean-shutdown 
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15.3.2 Configuring Linux Virtual Server as a Load Balancer 


Consult the following online sources for instructions for setting up Linux Virtual Server as a load 
balancer for your Novell Vibe site: 


* The Linux Virtual Server Project (http://www.linuxvirtualserver.org) 
¢ Linux Virtual Server (LVS) Project (http://www.austintek.com/LVS) 


* Linux Virtual Server Tutorial (http://www.ultramonkey.org/papers/Ivs_tutorial/html) 


15.4 Configuring Internet Information Services to 
Support Multiple Vibe Servers 


You can configure Internet Information Services (IIS) to support multiple Novell Vibe servers. For 
more information, see Section 9.10.10, “Configuring IIS to Load Balance in a Clustered Environment,” 
on page 115. 
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Running Multiple Lucene Index Servers 


Your Novell Vibe site depends on the Lucene Index Server for full functionality. Different Lucene 
configurations provide different levels of scalability and reliability. 


You can install the Lucene Index Server on a different server from where Vibe is running so that both 
programs have access to more server memory, disk space, and CPU resources. However, the Vibe 

server and the Lucene Index Server must not have a firewall between them. The RMI protocol used 

for the Lucene Index Server port works only within a trusted local area network (LAN). 


* A Basic installation of Vibe places the Lucene Index Server on the same server where the Vibe 
software is installed. 


¢ To provide additional memory for the Lucene Index Server, you might already have configured it 
to run in its own memory space, as described in Section 9.6.3, “Running the Lucene Index 
Server in Its Own JVM,” on page 100. 


¢ To provide additional disk space and memory for the Lucene Index Server, you might already 
have moved it to a different server, as described in Chapter 14, “Installing the Lucene Index 
Server on a Remote Server,” on page 135. 


These configurations provide additional resources for the Lucene Index Server, but it is still a single 
point of failure for your Vibe site. If the Lucene Index Server goes down, the Vibe site becomes 
inaccessible until access to the Lucene Index Server is restored. 


Running multiple Lucene Index Servers provides high availability functionality, so that if one Lucene 
Index Server goes down, Vibe users can still access the Vibe site because other Lucene Index 
Servers are still available. 

* Section 16.1, “Planning a High Availability Lucene Configuration,” on page 147 

* Section 16.2, “Setting Up a High Availability Lucene Configuration,” on page 148 

* Section 16.3, “Testing Your Lucene High Availability Configuration,” on page 160 

* Section 16.4, “Synchronizing a High Availability Lucene Configuration,” on page 162 


NOTE: This section assumes that you already have a Basic installation of Vibe up and running 
successfully. We highly recommend that you follow the instructions in Part Il, “Basic Installation,” on 
page 33 before attempting a more complex Vibe and Lucene configuration. 


16.1 Planning a High Availability Lucene Configuration 


A high availability Lucene Index Server configuration must include at least two different servers 
(either physical or virtual), referred to as “nodes” in the Vibe installation program. Lucene nodes ina 
high availability configuration can be set up on Linux servers, Windows servers, or both. 


Each Lucene node must have its own independent directory structure for index files. The default 
location for the index files for the Lucene Index Server varies by platform: 


Linux: /var/opt/novell/teaming/lucene 


Windows: c:\Novell\Teaming\lucene 
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16.2.1 


As you plan your high availability Lucene configuration, you can use the Advanced Vibe Installation 
Summary Sheet to record the options you want to use. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under High Availability Lucene Configuration, specify the number of Lucene nodes that you want in your 
high availability Lucene configuration. 


Each Lucene node needs a unique name, a descriptive title, and a static IP address. The name and 
title identify the node in the Vibe administrative interface. Typically, the Lucene Index Server listens 
on RMI port 1199 on its server, but you can configure it to use a different port number if the default 
port number is already in use. 


ADVANCED VIBE INSTALLATION SUMMARY SHEET 


Under High Availability Lucene Configuration, specify the name, description, IP address, and RMI port 
number for each Lucene node. 


If you have already accumulated index data on your initial Vibe server, you can choose to copy the 
index files to the Lucene nodes, or you can reindex the Vibe site after the new Lucene nodes are 
running. Depending on the amount of accumulated index data, reindexing can be a time-consuming 
process. 


The Vibe server and the Lucene nodes must not have a firewall between them. The RMI protocol 
used for the Lucene Index Server port works only within a trusted local area network (LAN). 


Setting Up a High Availability Lucene 
Configuration 


* Section 16.2.1, “Changing from a Local Lucene Index Server,” on page 148 
* Section 16.2.2, “Changing from a Single Remote Lucene Index Server,” on page 151 
* Section 16.2.3, “Expanding an Existing High Availability Lucene Configuration,” on page 154 


* Section 16.2.4, “Changing Your Lucene Configuration without Vibe Site Down Time,” on 
page 156 


Changing from a Local Lucene Index Server 


To change from a local Lucene Index Server running on the Novell Vibe server, you must install the 
Lucene Index Server on two or more remote servers, then reconfigure Vibe for a high availability 
Lucene configuration. 


NOTE: Although it is possible to use the Lucene Index Server on the Vibe server as one of the 
“remote” Lucene nodes, this is not a recommended configuration. Consider it only if you are restricted 
to two servers for your Vibe site. 


1 Set up two or more Lucene nodes: 


1a Install the Lucene Index Server on each node, as described in Section 14.1, “Installing the 
Lucene Software,” on page 135. 


1b (Optional) Copy accumulated index data from the initial Lucene Index Server to each 
additional Lucene node. 
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The default location for the index files varies by platform: 


Linux: /var/opt/novell/teaming/lucene 


Windows: c:\Novell\Teaming\lucene 


Start the Lucene Index Server on each Lucene node, as described in Section 14.3, 
“Managing a Remote Lucene Index Server,” on page 137. 


2 Stop Vibe. 


If you have installed the Vibe software on multiple servers, as described in Chapter 15, “Running 
Vibe on Multiple Servers,” on page 139, stop Vibe on all servers, or follow the instructions in 
Section 16.2.4, “Changing Your Lucene Configuration without Vibe Site Down Time,” on 

page 156. 


3 Run the Vibe installation program to configure the Vibe server for multiple Lucene nodes: 


3a 
3b 
3c 
3d 


3e 
3f 


On the Installation Settings page, select Reconfigure Settings, then click Next. 

On the Choose Installation Type page, select Advanced, then click Next. 

Click Next to proceed through the installation pages where no changes are needed. 
On the Lucene Configuration page, fill in the following fields: 

Lucene configuration type: Select high availability. 


Number of high availability search nodes: Specify the number of Lucene nodes where 
you have installed and started the Lucene Index Server. 


Novell Vibe 3 Installation Program 


Lucene Configuration 


Use the following fields to configure the Lucene index. 


To run the Lucene index as a server, select Server from the drop-down list. 
You can run Lucene as a server on the same machine where the Vibe software is installed or on a 
remote machine. 


Enter the host name and edit the RMI port if the default port cannot be used. 


Max booleans |10000 


Merge factor 10 
Lucene configuration type: high availability “| 


Number of high availability search nodes: 


Click Next. 


On the Configure High Availability Search Nodes page, specify the configuration information 
for each Lucene node from the Advanced Vibe Installation Summary Sheet that you filled 
out in Section 16.1, “Planning a High Availability Lucene Configuration,” on page 147, then 
click Next. 
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Configure High Availablity Search Nodes 


Configure the high availability search nodes specified in the previous panel. 


Use the following fields to configure each high availability search node. 


To remove one of the high available search nodes, unselect its "Keep" check box. 


Enter the high availability service name, host name and edit the RMI Port if the default port cannot 


be used. 


M Keep Service name 
Service title 

Host 

RMI port 


rHigh Availability Search Node 1 


|LuceneLinux 
|Lucene on Linux 


/172.16.5.2 


11199 


M Keep Service name 
Service title 

Host 

RMI port 


rHigh Availability Search Node 2 


|LuceneWindows 


Lucene on Windows 


|172.16.5.19 


1199 


If you need more than 2 high availability search nodes, you will need 
to select "< Back" and increase the specified number of nodes. 


3g Click Next until you reach the Ready to Install page, then click Install. 


3h On the Installation Complete page, click Finish. 


3i Start Vibe. 


3j (Conditional) If you have multiple Vibe servers, repeat Step 3 on each Vibe server. 


4 Configure the Vibe site for the additional Lucene nodes: 


4a Log in to the Vibe site as the Vibe administrator. 


4b Click the Settings icon [EE in the upper right corner of the page, then click the 


Administration Console icon IO] 


4c Under Search 


Index, click Nodes. 
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Lucene on Linux (lucenelinux) 


Host: 172.16.5.2 
RMI port: 1199 


User Mode Access 
® Read and Write 
Write Only 
No Access 


V| Enable Deferred Update Log 


No Deferred Update Log Record Exists 


Lucene on Windows (lucenewindows) 


Host: 172.16.5.19 
RMI port: 1199 


User Mode Access 
Read and Write 
® Write Only 
No Access 


V| Enable Deferred Update Log 


No Deferred Update Log Record Exists 


By default, the first Lucene node in the list has Read and Write access, meaning that Vibe 

updates it as new content is added to the Vibe site. By default, subsequent nodes in the list 
have Write Only access, meaning that the Vibe software can update content on the server, 
but users cannot access it. This setting is useful when you need to perform maintenance on 
a Lucene node, but it is not the setting you want when you set up a new Lucene node. 


4d Inthe User Mode Access box, select Read and Write for all Lucene nodes, click Apply, then 
click Close. 


The new setting is put into effect immediately, so that users immediately have access to the 
additional Lucene nodes. 


5 Skip to Section 16.3, “Testing Your Lucene High Availability Configuration,” on page 160. 


Changing from a Single Remote Lucene Index Server 


To change from a single remote Lucene Index Server to a high availability configuration, you must 
install the Lucene Index Server on one or more additional remote servers, then reconfigure Novell 
Vibe for additional Lucene nodes. 


1 Bring down your Vibe site: 
la Stop Vibe. 


If you have installed the Vibe software on multiple servers, as described in Chapter 15, 
“Running Vibe on Multiple Servers,” on page 139, stop Vibe on all servers, or follow the 
instructions in Section 16.2.4, “Changing Your Lucene Configuration without Vibe Site Down 


Time,” on page 156. 
1b Make sure that the existing remote Lucene Index Server also stops. 
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2 Set up one or more additional Lucene nodes: 


2a Install the Lucene Index Server on each additional remote server, as described in 
Section 14.1, “Installing the Lucene Software,” on page 135. 


2b (Optional) Copy accumulated index data from the initial remote Lucene node to each 
additional Lucene node. 


The default location for the index files varies by platform: 


Linux: /var/opt/novell/teaming/lucene 


Windows: c:\Novell\Teaming\lucene 


2c Start the Lucene Index Server on each Lucene node, as described in Section 14.3, 
“Managing a Remote Lucene Index Server,” on page 137, but do not bring up your Vibe site. 


3 Run the Vibe installation program to configure the Vibe server for multiple Lucene nodes: 
3a On the Installation Settings page, select Reconfigure Settings, then click Next. 
3b On the Choose Installation Type page, select Advanced, then click Next. 
3c Click Next to proceed through the installation pages where no changes are needed. 
3d On the Lucene Configuration page, fill in the following fields: 
Lucene configuration type: Change server to high availability. 


Number of high availability search nodes: Specify the number of Lucene nodes where 
you have installed the Lucene Index Server. 
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Lucene Configuration 


Use the following fields to configure the Lucene index. 


To run the Lucene index as a server, select Server from the drop-down list. 
You can run Lucene as a server on the same machine where the Vibe software is installed or on a 
remote machine. 


Enter the host name and edit the RMI port if the default port cannot be used. 


Max booleans | 10000 


Merge factor 10 
Lucene configuration type: high availability “| 


Number of high availability search nodes: esd 


3e Click Next. 


3f On the Configure High Availability Search Nodes page, specify the configuration information 
for each Lucene node from the Advanced Vibe Installation Summary Sheet that you filled 
out in Section 16.1, “Planning a High Availability Lucene Configuration,” on page 147, then 
click Next. 
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Configure High Availablity Search Nodes 


Configure the high availability search nodes specified in the previous panel. 


Use the following fields to configure each high availability search node. 
To remove one of the high available search nodes, unselect its "Keep" check box. 


Enter the high availability service name, host name and edit the RMI Port if the default port cannot 
be used. 


rHigh Availability Search Node 1 
M Keep Service name |LuceneLinux 


Service title Lucene on Linux 


Host [172.16.5.2 
RMI port [1199 


rHigh Availability Search Node 2 
M Keep Service name LuceneWindows 


Service title Lucene on Windows 
Host |172. 16.5.19 
RMI port |1199 


If you need more than 2 high availability search nodes, you will need 
to select "< Back" and increase the specified number of nodes. 


3g Click Next until you reach the Ready to Install page, then click Install. 

3h On the Installation Complete page, click Finish. 

3i Start Vibe. 

3j (Conditional) If you have multiple Vibe servers, repeat Step 3 on each Vibe server. 
4 Configure the Vibe site for the additional Lucene nodes: 

4a Log in to the Vibe site as the Vibe administrator. 


4b Click the Settings icon [EE in the upper right corner of the page, then click the 


Administration Console icon IO] 
4c Under Search Index, click Nodes. 


Lucene on Linux (lucenelinux) 


Host 172.16.5.2 
RMI port: 1199 


User Mode Access 
® Read and Write 
Write Only 
D No Access 


[7] Enable Deferred Update Log 
No Deferred Update Log Record Exists 


Lucene on Windows (lucenewindows) 
Host 172.16.5.19 
RMI port: 1199 
User Mode Access 
Read and Write 
© write Only 
No Access 


[7] Enable Deferred Update Log 


No Deferred Update Log Record Exists 
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By default, the first Lucene node in the list has Read and Write access, meaning that Vibe 

updates it as new content is added to the Vibe site. By default, subsequent nodes in the list 
have Write Only access, meaning that the Vibe software can update content on the server, 
but users cannot access it. This setting is useful when you need to perform maintenance on 
a Lucene node, but it is not the setting you want when you set up a new Lucene node. 


4d In the User Mode Access box, select Read and Write for all Lucene nodes. 
4e Click Apply, then click Close. 


The new setting is put into effect immediately, so that users immediately have access to the 
additional Lucene nodes. 


5 Skip to Section 16.3, “Testing Your Lucene High Availability Configuration,” on page 160. 


16.2.3 Expanding an Existing High Availability Lucene 
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Configuration 


After you have set up an initial high availability Lucene configuration, you can add additional Lucene 
nodes at any time. 
1 Bring down your Vibe site: 
la Stop Vibe. 


If you have installed the Vibe software on multiple servers, as described in Chapter 15, 
“Running Vibe on Multiple Servers,” on page 139, stop Vibe on all servers, or follow the 
instructions in Section 16.2.4, “Changing Your Lucene Configuration without Vibe Site Down 
Time,” on page 156. 


1b Stop all Lucene nodes, as described in Section 14.3, “Managing a Remote Lucene Index 
Server,” on page 137. 


2 Set up one or more additional Lucene nodes: 


2a Install the Lucene Index Server on each additional remote server, as described in 
Section 14.1, “Installing the Lucene Software,” on page 135. 


2b (Optional) Copy accumulated index data from an existing Lucene node to each additional 
Lucene node. 


The default location for the index files varies by platform: 


Linux: /var/opt/novell/teaming/lucene 


Windows: c:\Novell\Teaming\lucene 


2c Start the Lucene Index Server on each Lucene node, as described in Section 14.3, 
“Managing a Remote Lucene Index Server,” on page 137, but do not bring up your Vibe site. 


3 Run the Vibe installation program to configure the Vibe server for the additional Lucene nodes: 
3a On the Installation Settings page, select Reconfigure Settings, then click Next. 
3b On the Choose Installation Type page, select Advanced, then click Next. 
3c Click Next to proceed through the installation pages where no changes are needed. 


3d On the Lucene Configuration page, increase the number of nodes in the Number of high 
availability search nodes field, then click Next. 
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[x | Novell Vibe 3 Installation Program 


Lucene Configuration 


Use the following fields to configure the Lucene index. N 


To run the Lucene index as a server, select Server from the drop-down list. 


You can run Lucene as a server on the same machine where the Vibe software is installed or on a 
remote machine. 


Enter the host name and edit the RMI port if the default port cannot be used. 


Max booleans | 10000 


Merge factor |10 


Lucene configuration type: high availability “| 


Number of high availability search nodes:________] 


3e On the Configure High Availability Search Nodes page, specify the configuration information 


for each additional Lucene node, then click Next. 


Novell Vibe 3 Installation Program 


Configure High Availablity Search Nodes 


Configure the high availability search nodes specified in the previous panel. N 


Use the following fields to configure each high availability search node. 
To remove one of the high available search nodes, unselect its "Keep" check box. 


Enter the high availability service name, host name and edit the RMI Port if the default port cannot 
be used. 


RMI port [1199 


High Availability Search Node 2 
M Keep Service name LuceneWindows 


Service title Lucene on Windows 


Host |172. 16.5.19 
RMI port [1199 


High Availability Search Node 3 
M Keep Service name | 


Service title | 


Host 
RMI port 1199 


If you need more than 3 high availability search nodes, you will need 
to select "< Back" and increase the specified number of nodes. A 


3f Click Next until you reach the Ready to Install page, then click Install. 

3g On the Installation Complete page, click Finish. 

3h Start Vibe. 

3i (Conditional) If you have multiple Vibe servers, repeat Step 3 on each Vibe server. 
4 Configure the Vibe site for the additional Lucene nodes: 

4a Login to the Vibe site as the Vibe administrator. 


4b Click the Settings icon EF in the upper right corner of the page, then click the 
Administration Console icon E. 
4c Under Search Index, click Nodes. 
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Lucene on Linux (lucenelinux) 
Host 172.16.5.2 
RMI port 1199 
User Mode Access 
® Read and Write 
Write Only 
No Access 


W) Enable Deferred Update Log 
No Deferred Update Log Record Exists 


Lucene on Windows (lucenewindows) 
Host 172.16.5.19 
RMI port: 1199 
User Mode Access 
Read and Write 
@ Write Only 
No Access 


7] Enable Deferred Update Log 


No Deferred Update Log Record Exists 


By default, the first Lucene node in the list has Read and Write access, meaning that Vibe 

updates it as new content is added to the Vibe site. By default, subsequent nodes in the list 
have Write Only access, meaning that the Vibe software can update content on the server, 
but users cannot access it. This setting is useful when you need to perform maintenance on 
a Lucene node, but it is not the setting you want when you set up a new Lucene node. 


4d In the User Mode Access box, select Read and Write for all Lucene nodes. 
4e Click Apply, then click Close. 


The new setting is put into effect immediately, so that users immediately have access to the 
additional Lucene nodes. 


5 Skip to Section 16.3, “Testing Your Lucene High Availability Configuration,” on page 160. 


16.2.4 Changing Your Lucene Configuration without Vibe Site 
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Down Time 


Vibe site down time can be avoided only if you have installed the Vibe software on multiple servers, 
as described in Chapter 15, “Running Vibe on Multiple Servers,” on page 139. 


To change to a high availability Lucene configuration in a multiple Vibe server configuration: 


1 Set up two or more Lucene nodes: 


1a Install the Lucene Index Server on each node, as described in Section 14.1, “Installing the 
Lucene Software,” on page 135 


1b Start the Lucene Index Server on each Lucene node, as described in Section 14.3, 
“Managing a Remote Lucene Index Server,” on page 137. 


2 Stop Vibe on one server. 


The other Vibe servers remain in service for users and continue to communicate with the original 
Lucene Index Server. 


3 Run the Vibe installation program on the Vibe server that you stopped to configure it for multiple 
Lucene Index Servers: 


3a On the Installation Settings page, select Reconfigure Settings, then click Next. 
3b On the Choose Installation Type page, select Advanced, then click Next. 


3c Click Next to proceed through the installation pages where no changes are needed. 
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3d On the Lucene Configuration page, fill in the following fields. 
Lucene configuration type: Select high availability. 


Number of high availability search nodes: Specify the number of Lucene nodes where 
you have installed the Lucene Index Server. 


Novell Vibe 3 Installation Program 


Lucene Configuration 


Use the following fields to configure the Lucene index. 


To run the Lucene index as a server, select Server from the drop-down list. 
You can run Lucene as a server on the same machine where the Vibe software is installed or on a 
remote machine. 


Enter the host name and edit the RMI port if the default port cannot be used. 


Max booleans | 10000 
Merge factor 10 
Lucene configuration type: high availability “| 


Number of high availability seach nodes: [2 


3e Click Next. 


3f On the Configure High Availability Search Nodes page, specify the configuration information 
for each Lucene node from the Advanced Vibe Installation Summary Sheet that you filled 
out in Section 16.1, “Planning a High Availability Lucene Configuration,” on page 147, then 
click Next. 
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Configure High Availablity Search Nodes 


Configure the high availability search nodes specified in the previous panel. 


Use the following fields to configure each high availability search node. 
To remove one of the high available search nodes, unselect its "Keep" check box. 


Enter the high availability service name, host name and edit the RMI Port if the default port cannot 
be used. 


rHigh Availability Search Node 1 


M Keep Service name LuceneLinux 


Service title Lucene on Linux 
Host | 172. 16.5.2 
RMI port 1199 


High Availability Search Node 2 
M Keep Service name LuceneWindows 


Service title Lucene on Windows 
Host |172.16.5.19 
RMI port |1199 


If you need more than 2 high availability search nodes, you will need 
to select "< Back" and increase the specified number of nodes. 


3g Click Next until you reach the Ready to Install page, then click Install. 
3h On the Installation Complete page, click Finish. 
4 Start the reconfigured Vibe server. 
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5 Access the reconfigured Vibe server and prevent access to the additional Lucene nodes: 


IMPORTANT: All Vibe servers must be reconfigured before any of them access the additional 
Lucene nodes. 


5a Log in to the reconfigured Vibe server as the Vibe administrator, using the server hostname 
rather than your Vibe site URL. 

5b Click the Settings icon EF in the upper right corner of the page, then click the 
Administration Console icon E 


5c Under Search Index, click Nodes. 


Lucene on Linux (lucenelinux) 
Host 172.16.5.2 
RMI port 1199 
User Mode Access 
® Read and Write 
Write Only 
No Access 


[7] Enable Deferred Update Log 


No Deferred Update Log Record Exists 


Lucene on Windows (lucenewindows) 


Host 172.16.5.19 
RMI port: 1199 


User Mode Access 
Read and Write 
@ Write Only 
No Access 
[7] Enable Deferred Update Log 


No Deferred Update Log Record Exists 


By default, the first Lucene node in the list has Read and Write access, meaning that Vibe 
updates it as new content is added to the Vibe site. By default, subsequent nodes in the list 
have Write Only access, meaning that the Vibe software can update content on the server, 
but users cannot access it. When you set up a high availability Lucene configuration without 
Vibe site down time, you need to prevent write access during the reconfiguration process. 


5d In the User Mode Access box, change Write Only to No Access for the additional Lucene 
nodes. 


5e Click Apply, then click Close. 


The new setting is put into effect immediately, so that the reconfigured Vibe server does not 
communicate with the additional Lucene nodes. 


6 Reconfigure the rest of the Vibe servers: 
6a Stop each Vibe server. 
6b Repeat Step 3 to configure each Vibe server for the additional Lucene nodes. 
6c Start each reconfigured Vibe server. 
7 Accessthe reconfigured Vibe site and allow write access to the additional Lucene nodes: 


7a Log in to the reconfigured Vibe as the Vibe administrator. 
7b Click the Settings icon EJ in the upper right corner of the page, then click the 


Administration Console icon IO] 
7c Under Search Index, click Nodes. 
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Lucene on Linux (LuceneLinux) 


Host:172.16.5.19 
RMI port: 1199 


User Mode Access 
© Read and Write 
© write Only 
© No Access 


M Enable Deferred Update Log 


No Deferred Update Log Record Exists 


Lucene on Windows (LuceneWindows) 


Host: 137.65.67.222 
RMI port: 1199 


User Mode Access 
O Read and Write 
© write Only 
© No Access 


V| Enable Deferred Update Log 


No Deferred Update Log Record Exists 


7d In the User Mode Access box, change No Access to Write Only for the additional Lucene 
nodes. 


7e Click Apply, then click Close. 


The new setting is put into effect immediately, so that the reconfigured Vibe servers can 
now communicate with the additional Lucene nodes, although user access is still 
disallowed. 


8 Reindex the Vibe site, so that the additional Lucene nodes are updated with the same index data 
that the original Lucene Index Server has: 


8a On the Administration page, under Search Index, click Index. 


Manage Search Index [TERA 


C] Re-Index Everything 


Select the Places to be Re-Indexed: 
(Selecting a folder or workspace will automatically index all folders and workspaces within it.) 


E Bt Home Workspace 

m] By Users and Groups 
Q gy Global Workspaces 
F] Bp Personal Workspaces 
A fa Team Workspaces 


Select the Nodes to Apply Re-Indexing to: 


Ifre-indexing all or large part of the tree, itis strongly recommended to change the access mode of the node(s) to write-only before starting 
re-indexing so that all read requests can go to the other unselected node(s) while re-indexing is in progress. Atleast one node must allow 
read-write at any given time. Once re-indexing is completed, change the access mode of the node(s) back to read-write so that search 
requests can use them again 


[El Lucene on Linux (lucenelinux) - Read and Write, Deferred Update Log Enabled, No Deferred Update Log Record Exists 
E Lucene on Windows (lucenewindows) - Write Only, Deferred Update Log Enabled, No Deferred Update Log Record Exists 


8b On the Manage Search Index tab, select Re-Index Everything, so that the entire Vibe site is 
reindexed. 


8c Select the additional Lucene nodes, but do not select any previously existing nodes. 
8d Click OK to start the indexing. 
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Depending on the size of your Vibe site, reindexing can be a time-consuming process. 
However, because one or more previously existing Lucene Index Servers are still servicing 
the Vibe site, users are not affected by the reindexing process. 


8e When the reindexing is completed, click Close. 
9 Make the additional Lucene nodes available to Vibe users: 


9a On the Administration page, under Search Index, click Nodes. 


Lucene on Linux (lucenelinux) 
Host 172.16.5.2 
RMI port: 1199 
User Mode Access 
® Read and Write 
Write Only 


No Access 


vj Enable Deferred Update Log 
No Deferred Update Log Record Exists 


Lucene on Windows (lucenewindows) 
Host: 172.16.5.19 
RMI port: 1199 
User Mode Access 
Read and Write 
@ Write Only 
No Access 


[7] Enable Deferred Update Log 


No Deferred Update Log Record Exists 


9b In the User Mode Access box, change Write Access to Read and Write for the additional 
Lucene nodes. 


9c Click Apply, then click Close. 


The new setting is put into effect immediately, so that Vibe users have additional Lucene 
Index Servers available as they use the Vibe site. 


Testing Your Lucene High Availability 
Configuration 


When you first set up your high availability Lucene configuration, you can configure Novell Vibe to 
write Lucene node information to the Tomcat log file so that you can observe the behavior of the 
Lucene nodes. Then you can take nodes down and bring them up again to see the effect on your Vibe 
site. This process helps you prepare for the situation where a Lucene node goes down unexpectedly 
or you need to take one down on purpose, perhaps for maintenance. 


* Section 16.3.1, “Configuring Vibe to Log Lucene Node Activity,” on page 161 
* Section 16.3.2, “Observing Lucene Node Activity,” on page 161 


NOTE: For background information about the Tomcat log file, see “Tomcat Log File” in “Site 
Maintenance” in the Novell Vibe 3.4 Administration Guide. 
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16.3.1 Configuring Vibe to Log Lucene Node Activity 


By default, Vibe writes an error to the Tomcat log file whenever it cannot communicate with a Lucene 
node. For testing purposes, you can change the logging level so that the Tomcat log file includes a 
message for each time Vibe contacts a Lucene Index Server. 


After observing and understanding the behavior, you should return the logging to normal levels. 


1 Open the 1094; .properties file in a text editor. 


The location of the 10g94j . properties file varies by platform. 


Linux: /opt/novell/teaming/apache-tomcat /webapps/ssf/WEB- INF 


Windows: c:\Program Files\Novell\Teaming\apache-tomcat\ 
webapps \ssf\WEB-INF 


2 Search for the following line: 
#log4j .category.com.novell.teaming.search=DEBUG 


3 Remove the pound sign (#) from the beginning of the line to activate the DEBUG logging level for 
the Lucene Index Server. 


The DEBUG logging level adds a message for each time Vibe contacts a Lucene Index. 
4 Save the 1og4j.properties file, then exit the text editor. 
5 Stop Vibe, then start Vibe to put the new logging level into effect. 


16.3.2 Observing Lucene Node Activity 


After changing the Vibe logging level to include Lucene node activity, you can monitor the Tomcat log 
file to see which Lucene nodes Vibe is contacting. 
1 Change to the directory where the Tomcat log file is located. 


For background information about the Tomcat log file, see “Tomcat Log File” in “Site 
Maintenance” in the Novell Vibe 3.4 Administration Guide. 


2 On Linux, use the tail command to monitor the end of the Tomcat log file. 
tail -f catalina.out 
or 


On Windows, download an equivalent command from the Internet in order to perform the 
following steps. 


For example, there is a command available at SourceForge.net (http://sourceforge.net/projects/ 
tailforwin32). 


3 Perform some activities on the Vibe site to create new content. 


For example, you could create a blog entry. The Tomcat log file shows that Vibe is contacting 
each available Lucene Index Server in turn as it submits the new information for indexing. Nodes 
are considered available if they are marked Read and Write in the User Mode Access box on the 
Lucene Nodes page. 


4 Bring down one of the Lucene nodes. 


For example, you might reboot the Lucene server, stop the Lucene Index Server on the node, or 
otherwise prevent Vibe from contacting the Lucene node. 


5 Observe that the Tomcat log file displays an error when the Lucene node becomes unavailable. 
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Perform some additional activities on the Vibe site that create new content. 


You might notice a pause as Vibe tries to connect with the Lucene node that is no longer 
available. 


Observe that the Tomcat log file shows when normal Vibe processing has resumed without 
access to the unavailable Lucene node. 


8 Make the unavailable Lucene node available again. 


9 Observe that the Tomcat log file indicates that Vibe has created a journal record on the Lucene 


10 


node that was temporarily unavailable. 


The journal record contains the indexing operations that failed to take place while the Lucene 
node was unavailable. Even though the Lucene node is back up, Vibe does not start accessing it 
until it has been synchronized with the latest index information. 


To synchronize the out-of-date Lucene node, follow the steps in Section 16.4, “Synchronizing a 
High Availability Lucene Configuration,” on page 162. 


After the out-of-date Lucene node has been synchronized, Vibe starts accessing it again. 


If a situation arises where no Lucene node is marked Read and Write in the User Mode Access box 
on the Lucene Nodes page, Vibe temporarily accesses the first node in the list that is set to Write 
Only. If no nodes are set to Write Only or Read and Write, Vibe temporarily access the first node in 
the list, even though it is set to No Access. This functionality is required because you cannot log in to 
the Vibe site without access to a Lucene Index Server. 


Synchronizing a High Availability Lucene 
Configuration 
You should ensure that your Lucene node servers remain in sync with each other. Whenever a 


Lucene node is down for a relatively short period of time (no more than one or two days), you can 
synchronize it with other Lucene nodes whose index files are up-to-date. 


1 Make sure that the out-of-date Lucene node is running reliably again. 


2 


Log in to the Novell Vibe site as the Vibe administrator. 


3 Click the Settings icon [EM in the upper right corner of the page, then click the Administration 


Console icon E 


4 Under Search Index, click Nodes. 


E] Enable Deferred Update Log 


No Defers ed Update Log Record Exists 
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5 To repair the out-of-date Lucene node, select Apply Deferred Update Log Records to the Index, 
then click Apply. 


The Deferred Update Log options disappear if the update is successful. If for some reason the 
deferred update log records cannot be applied to the index, you can rebuild the index, as 
described in “Rebuilding the Lucene Index” in “Site Maintenance” in the Novell Vibe 3.4 
Administration Guide. 


6 Click Close. 
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Running Multiple Database Servers 


Each of the three databases supported by Novell Vibe (MySQL, Microsoft SQL, and Oracle) has its 
own approach to clustering the database server. Information about clustering database servers is 
available on the Internet, for example: 


* MySQL Cluster (http:/Awww.mysql.com/products/database/cluster) 


* SQL Server Clustering (http://www.sql-server-performance.com/articles/clustering/ 
clustering_intro_p1.aspx) 

* Oracle Real Application Clusters (http://www.oracle.com/technology/products/database/ 
clustering) 


NOTE: We highly recommend that you follow the instructions in Part II, “Basic Installation,” on 
page 33 before attempting a more complex Vibe configuration. 
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V Update 


* Chapter 18, “What's New in Novell Vibe 3.x,” on page 169 

* Chapter 19, “Updating from Vibe 3.4 to Vibe 3.4 HP2,” on page 173 

* Chapter 20, “Updating From Novell Vibe 3.3 to Novell Vibe 3.4,” on page 175 

* Chapter 21, “Updating From Novell Vibe 3.2 to Novell Vibe 3.3,” on page 181 

* Chapter 22, “Updating From Novell Vibe 3.1 to Novell Vibe 3.3,” on page 189 

* Chapter 23, “Updating from Novell Vibe 3 to Novell Vibe 3.3,” on page 197 

* Chapter 24, “Updating the Operating System Where Vibe Is Running,” on page 205 
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18.1 


18.2 


18.3 


What’s New in Novell Vibe 3.x 


Novell Vibe is the new name for the product formerly known as Novell Teaming. This section 
describes new features that have been added to Novell Vibe 3.x. 

¢ Section 18.1, “Vibe 3.x User Enhancements,” on page 169 

* Section 18.2, “Vibe 3.x Installation Enhancements,” on page 169 


¢ Section 18.3, “Vibe 3.x Administration Enhancements,” on page 169 


Vibe 3.x User Enhancements 


For a list of Novell Vibe enhancements and instructions for use, see: 


* “What's New in Novell Vibe 3.x” in the Novell Vibe 3.4 User Guide 
+ “What's New in Vibe 3.x”in the Novell Vibe 3.4 Advanced User Guide 


Vibe 3.x Installation Enhancements 


* Support for memcached caching (v3.2): Memcached is a high-performance, distributed 
caching system that is suitable for large clustered Vibe systems. For more information, see 
Section 15.2, “Installing the Vibe Software on Multiple Servers,” on page 140. 


* Support for Windows Authentication (v3.1): You can configure a single sign-on experience 
for your users when you run Novell Vibe on a Windows server. For more information, see 
Section 9.10, “Configuring Single Sign-On with Internet Information Services for Windows,” on 
page 103. 


Vibe 3.x Administration Enhancements 


* External User access (v3.4): External users can be added to the Vibe system at no additional 
cost with Vibe 3.4 and later. See the Novell Software License Agreement for restrictions 
associated with this feature. For more information about external users, see “Managing External 
Users” in the Novell Vibe 3.4 Administration Guide. 


+ 


Licensing Changes for the Guest user (v3.4): Guest access is included without the need to 
purchase a separate license with Vibe 3.4 and later. For more information about the Guest user, 
see “Allowing Guest Access to Your Vibe Site” in the Novell Vibe 3.4 Administration Guide. 


+ 


Site Branding Applies to Guest User Workspace (v3.4): Now when you brand the Vibe site, 
the site branding is displayed on the Guest User workspace by default. For more information 
about branding the Vibe site, see “Creating a Site-Wide Brand” in the Novell Vibe 3.4 
Administration Guide. 


+ 


Create dynamic groups (v3.3): You can create dynamic groups based on LDAP queries 
directly from Vibe. For more information, see “Creating Groups of Users” in the Novell Vibe 3.4 
Administration Guide. 
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+ 
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Configure Novell Vibe Desktop and Novell Vibe Add-In (v3.3): Vibe Desktop and the Vibe 
Add-in enable users to work with Vibe files directly from their workstation’s file system or directly 
from Microsoft Office. For information about the configuration options you can select for the Vibe 
site, see “Configuring Vibe Desktop and the Microsoft Office Add-In” in the Novell Vibe 3.4 
Administration Guide. 


Weekend and Holiday Schedule Used in Workflow Transitions (v3.3): Users can now 
transition entries through a workflow after a specified number of business days (excluding 
weekends and holidays). This functionality is based on the weekend and holiday schedule that 
you configure, as described in “Configuring Weekends and Holidays” inthe Novell Vibe 3.4 
Administration Guide. 


For more information about transitioning entries through a workflow after a specified number of 
business days, see “Transition After Time Elapsed” in “Creating and Managing Workflows” in the 
Novell Vibe 3.4 Advanced User Guide. 


Monitor the Vibe Site with JMX (v3.2): You can now monitor your Vibe site through JMX. For 
more information, see “Using JMX to Monitor the Vibe Site” in the Novell Vibe 3.4 Administration 
Guide. 


Disable User Accounts (v3.1): You can disable user accounts rather than delete them. For 
more information, see “Disabling Vibe User Accounts” in the Novell Vibe 3.4 Administration 
Guide. 


E-Mail Report (v3.1): You can generate reports for all e-mail messages sent from and into the 
Vibe site, as well as e-mail errors that have been encountered. For more information, see “E-Mail 
Report” in the Novell Vibe 3.4 Administration Guide. 


Restricting User Access by IP Address (v3.1): You can restrict what information users can 
access when they are outside your corporate firewall. For more information, see “Restricting 
Access Rights of Users Outside the Firewall” in the Novell Vibe 3.4 Administration Guide. 


Workspace and Folder Data Quotas (v3.1): You can limit the amount of information that can 
exist in specific workspaces and folders. For more information, see “Managing Workspace and 
Folder Data Quotas” in the Novell Vibe 3.4 Administration Guide. 


Configuring Search Functionality (v3.1): You can configure the settings for how items are 
indexed and how searches are executed on the Vibe site. For more information, see 
“Understanding and Configuring Search Functionality” in the Novell Vibe 3.4 Administration 
Guide. 


Site-Wide Brand: You can create a site-wide brand and manage how users can create 
individual brands on lower-level workspaces. For more information, see “Creating a Site-Wide 
Brand” inthe Novell Vibe 3.4 Administration Guide. 


Default Home Page: You can set a default home page for all users when they access the Novell 
Vibe site. You can create a separate default home page for visitors. For more information, see 
“Setting a Default Home Page” in the Novell Vibe 3.4 Administration Guide. 


User and Group Management: When you move or rename users and groups that are being 
synchronized via LDAP, Vibe now recognizes the change and maintains the association between 
the user or group that was moved or renamed and the LDAP server. For more information, see 
“LDAP Attribute to Identify a User or Group” on page 53. 


User Visibility: You can hide one set of users from another set of users. For example, you might 
want to do this if your Vibe site has users from more than one company and you want users to 
see only the users who belong to the same company. For more information, see “Restricting 
Groups of Users from Seeing One Another” in the Novell Vibe 3.4 Administration Guide. 


Integrations with Novell Messenger: Vibe 3 provides tight integrations with Novell Messenger, 


which allows Vibe users to see who is currently online. Presence icons & are located next to 
users’ names in folder entries. 
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Vibe administrators must configure Novell Messenger to work with Novell Vibe, as described in 
“Integrating Messenger with Vibe” in the Novell Vibe 3.4 Administration Guide. 


Expanded User Profile: The User Profile section in Vibe 3 has been expanded to rival other 
professional knowledgebases such as Linkedin. Now users can include more information to 
share with their colleagues, such as education, qualifications, and competencies. For more 
information, see “Modifying Your Profile” in the Novell Vibe 3.4 User Guide. 


For information about how Vibe administrators can modify the information that is displayed in the 
profile view, see “Customizing the Default User Profile View” in “Setting Up Users’ Personal 
Workspaces” in the Novell Vibe 3.4 Administration Guide. 


If you have modified the User Profile definition for your Vibe site, these changes are not 
displayed when you update to Vibe 3. To display these changes, complete the steps in 
Section 23.4.1, “Resetting Your Definitions,” on page 202. 


Profile Quick View Dialog Box: The Profile Quick View dialog box is displayed when users 


click a user’s Presence icon ®. It enables them to see information about that user, view the 
user’s micro-blog or workspace, follow the user, and more. 


For information about how Vibe administrators can modify the information that is displayed in the 
Profile Quick View, see “Customizing the Default Profile Quick View” in the Novell Vibe 3.4 
Administration Guide. 


If you have modified the User Profile definition for your Vibe site, this dialog box is not displayed 
when you update to Vibe 3. To display these changes, complete the steps in Section 23.4.1, 
“Resetting Your Definitions,” on page 202. 


Ability to Send Vibe Mail Messages from a Custom Address: You can configure Vibe to 
send e-mail messages from a zone-specific or site-wide address. In previous versions of Vibe, 
when a user sends an e-mail message from Vibe, the message can be shown only as being from 
that specific user. 


For more information, see “Configuring Vibe to Send E-Mail Messages and Notifications from a 
Custom Address” in the Novell Vibe 3.4 Administration Guide. 
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19.1 


19.2 


19.3 


Updating from Vibe 3.4 to Vibe 3.4 HP2 


Before starting the upgrade process, complete the instructions in the following sections: 


* Section 19.1, “Updating the Java Development Kit (JDK),” on page 173 
* Section 19.2, “Installing the Java Cryptography Extension (JCE),” on page 173 
¢ Section 19.3, “Re-Installing the Windows Service,” on page 173 


Updating the Java Development Kit (JDK) 


Vibe 4 requires the latest version of the IBM or Oracle JDK. 


Before you begin the upgrade process, update to the latest JDK, as described in Section A.1, “Java 
Development Kit (JDK),” on page 221. 


Installing the Java Cryptography Extension (JCE) 


Vibe 4 requires that you also install the Java Cryptography Extension (JCE) in addition to the JDK on 
each server in your Vibe system. (This was not a requirement in Vibe 3.4 and earlier.) 


Before you begin the upgrade process, install the JCE on each server in your Vibe system, as 
described in Section A.2, “Java Cryptography Extension (JCE),” on page 205. 


Re-Installing the Windows Service 


If you installed Vibe as a Windows service (as described in “Running Vibe as a Windows Service” on 
page 73), you must remove the service and re-install it. This is necessary because the original 
service references an unsupported version of Tomcat. 


To re-install the Windows service, do the following: 


1 In a Command Prompt window, change to the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows 

2 In the windows directory, copy the files from the appropriate subdirectory. 
The following subdirectories exist: x86, x64, ia64. 


If you are unsure which subdirectory is appropriate for your server, use the readme.txt file 
located in the c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows directory as 
a reference. 


3 Paste the files into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory. 


4 The Vibe installation program created a service .bat file for configuring Vibe to run as a 
Windows service. 


Use the following command to remove Vibe as a Windows service: 


service.bat remove existing-service-name 
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where existing-service-name is the service being removed as listed under Services (Local) > 
Apache Tomcat... Properties > General tab. 


5 Use the following command to configure Vibe as a Windows service: 
service.bat install new-service-name 


where new-service-name is the name of the service you are creating. 
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Updating From Novell Vibe 3.3 to Novell 
Vibe 3.4 


This section describes how to update from Novell Vibe 3.3 to Novell Vibe 3.4. You must update to 
Vibe 3.3 if you have not already, as described in Chapter 21, “Updating From Novell Vibe 3.2 to 
Novell Vibe 3.3,” on page 181. You cannot update from a version prior to Vibe 3.3 to Vibe 3.4. 


After you update your Vibe system, ensure that you check the Vibe download site where you 
downloaded the Vibe software for any hot patches that might be available. 


* Section 20.1, “Understanding the Update Process,” on page 175 

¢ Section 20.2, “Updating a Single-Server System from Vibe 3.3 to Vibe 3.4,” on page 175 
¢ Section 20.3, “Updating a Multiple-Server System from Vibe 3.3 to Vibe 3.4,” on page 177 
* Section 20.4, “Performing Post-Update Tasks,” on page 178 


20.1 Understanding the Update Process 


During the update from Novell Vibe 3.3 to Vibe 3.4, the following aspects of your Vibe system are 
modified: 


* The software is updated from Vibe 3.3 to Vibe 3.4. 


* A backup copy of your existing Vibe 3.3 installation is created in the following directory: 


Linux: /opt/novell/teaming/teaming-backup 

Windows: C:\Program Files\Novell\Teaming\teaming-backup 

If your original Vibe system began with version 1.0 (this version of Novell Vibe is called Novell 
Teaming), the backup copy is located in the following directory: 

Linux: /opt/icecore 


Windows: C:\Program Files\icecore 


20.2 Updating a Single-Server System from Vibe 3.3 to 
Vibe 3.4 


When you update a single-server Novell Vibe installation from Vibe 3.3 to Vibe 3.4, only the Vibe 
software needs to be updated. The database does not need to be updated because there were no 
database changes from Vibe 3.3 to Vibe 3.4. 

¢ Section 20.2.1, “Backing Up Vibe Data,” on page 176 

¢ Section 20.2.2, “Updating the Vibe Database from 3.3 to 3.4,” on page 176 

* Section 20.2.3, “Updating the Vibe Software,” on page 176 
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20.2.1 


20.2.2 


20.2.3 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Updating the Vibe Database from 3.3 to 3.4 


Vibe 3.4 does not contain any database changes, so there is no need to update the database when 
updating from Vibe 3.3. 


Updating the Vibe Software 


1 Ensure that you have a current backup of your Vibe 3.3 system. 
2 Stop Vibe. 
3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 


Vibe 3.3 system. 


Copy the installer.xml file from the directory where the Vibe 3.3 Installation program is 
located to the directory where you have extracted the Vibe 3.4 software. 


The installer.xml file provides default values when you run the Vibe 3.4 Installation program. 
Start the Vibe 3.4 installation program. 


If you need assistance with this task, see the detailed installation instructions for the platform 
where you are updating Vibe: 


* Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63 
* Section 4.2.2, “Running the Windows Vibe Installation Program,” on page 71 


Accept the License Agreement, then click Next. 


Novell Vibe 3 Installation Program 


Installation Options 


Select the action you want to perform. 


© New installation 
‘* Update software and settings 
Reconfigure settings 


Because you provided your Vibe 3.3 installer.xml1 file in the directory with the Vibe 3.4 
installation program, the Update software and settings installation option is selected by default. 


7 Click Next to continue. 


8 Click Yes to let the Installation program know that you have stopped Vibe. 


9 Select the check box to let the installation program know that you have backed up all of your 


10 


data, then click Next. 


Select Basic or Advanced, depending on the type of Vibe installation you are updating, then click 
Next. 


For more information about the differences between basic and advanced installations, see 
Section 3.1, “What Is a Basic Vibe Installation?,” on page 35 and Section 9.1, “What Is an 
Advanced Installation?,” on page 95. 
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20.3 


20.3.1 


20.3.2 


20.3.3 


11 Continue through the installation process, retaining or changing configuration information 
depending on the needs of your Vibe 3.4 system. 


12 Click Install when you are ready to perform the update. 
13 Click Finish when the update is completed. 
14 Start Vibe 3.4 in the same way that you have been starting Vibe 3.3. 


When you start Vibe for the first time after the update, it takes longer to start than usual because 
data in the Vibe database must be updated before the Vibe site is ready to use. 


Updating a Multiple-Server System from Vibe 3.3 
to Vibe 3.4 


If your Novell Vibe 3.3 system is distributed across multiple servers, the Vibe 3.4 installation program 
can update Vibe components on the Vibe server, but you must manually update any Vibe 
components that you have placed on remote servers. The database does need to be updated 
because there were no database changes from Vibe 3.3 to Vibe 3.4. 

* Section 20.3.1, “Backing Up Vibe Data,” on page 177 

* Section 20.3.2, “Manual Vibe Database Update,” on page 177 


* Section 20.3.3, “Remote Lucene Index Server Update,” on page 177 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Manual Vibe Database Update 


Vibe 3.4 does not contain any database changes, so there is no need to update the database when 
updating from Vibe 3.3. 


Remote Lucene Index Server Update 


To update your index from Novell Vibe 3.3 to Novell Vibe 3.4 when the Vibe installation program 
cannot do it for you, you need to run the Remote Lucene Server installation program. 

1 Stop Vibe. 

2 Stop the Lucene Index Server. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.3 system. 


4 Copy the Vibe 3.4 Remote Lucene Server Installation program from the directory where the Vibe 
3.4 Installation program is located to a convenient directory on the server where the remote 
Lucene Index Server is located. 


The name of the Remote Lucene Server Installation program varies by platform: 


Linux: lucene-installer.linux 


Windows: lucene-installer.exe 
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20.4 


20.4.1 


Start the Vibe 3.4 Remote Lucene Server installation program. 
Accept the License Agreement, then click Next. 
Select Update software and settings. 


Click Next to continue. 


O ON DI VI 


Click Next to accept the installation location. 

10 Click Next to accept the Java JDK location. 

11 In the Host field, specify the hostname where you are installing the remote Lucene Index Server. 
12 Change Lucene configuration settings as needed, then click Next. 


For information about Lucene configuration settings, see Section 9.6.2, “Changing Lucene 
Configuration Settings,” on page 100. 


13 Click Install to install the updated Lucene Index Server software. 
14 Click Finish when the update is completed. 
15 Start the Lucene Index Server. 


16 Now that all remote Vibe components have been updated, follow the instructions in Section 20.2, 
“Updating a Single-Server System from Vibe 3.3 to Vibe 3.4,” on page 175. 


Performing Post-Update Tasks 


After you start Novell Vibe 3.4, you can access your Vibe site as usual. However, you need to reset 
some aspects of the interface before you allow users to access the updated site. The interface reset 
affects only those definitions and templates that are included with the Vibe product. If you have 
created custom definitions and templates, they are unaffected by the interface reset. 


* Section 20.4.1, “Resetting the Search Index,” on page 178 
* Section 20.4.2, “Resetting Your Definitions,” on page 179 
* Section 20.4.3, “Resetting the Standard Templates,” on page 180 


Resetting the Search Index 


There have been no modifications to search functionality in Vibe 3.4. However, if you missed some of 
the changes from previous releases, you might want to re-index the search index. 


The steps to reset the search index differ depending on whether you have multiple Lucene Index 
servers. For more information about multiple search indexes, see Chapter 16, “Running Multiple 
Lucene Index Servers,” on page 147. 


Depending on the size of your Vibe site, this can be a very time-consuming process. 


* “Resetting a Single Search Index” on page 178 


* “Resetting the Search Index with Multiple Index Servers” on page 179 


Resetting a Single Search Index 


1 Login to the Vibe site as the Vibe administrator. 


2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon E 


3 In the Management section, click Search Index. 
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4 Select Re-Index Everything. 
5 Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


A message notifies you when indexing is complete. 


Resetting the Search Index with Multiple Index Servers 


1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EJ in the upper right corner of the page, then click the Administration 
Console icon E 

In the Search Index section, click Index. 

Select Re-Index Everything. 

Select each node that you want to re-index. 

Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


on A WwW 


A message notifies you when indexing is complete. 


20.4.2 Resetting Your Definitions 


There have been no modifications to definitions in Vibe 3.4. However, if you missed some of the 
changes from previous releases, you might want to reset the definitions. 


WARNING: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe definitions. If you want to save any modified definitions before proceeding, 
you can export the modified definitions. Also, you might want to document exactly what changes you 
have made in order to make it easier to reconstruct the definition after you reset it. This applies only 
to definitions that you have modified; definitions that you have created are not affected. 


To reset your Vibe definitions: 
1 Log in to the Vibe site as the Vibe administrator. 
2 Click the Settings icon [EMY in the upper right corner of the page, then click the Administration 
Console icon E 
3 In the System section, click Form/View Designers to display the Form and View Designers page. 
4 Click Reset. 
The Reset Definitions page is displayed. 


5 Click Select All. 
You can expand each definition to ensure that all definitions have been selected. 


6 Click OK. 
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20.4.3 


Resetting the Standard Templates 


There have been no modifications to Vibe templates in Vibe 3.4. However, if you missed some of the 
changes from previous releases, you might want to reset the definitions. 


IMPORTANT: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe templates. If you have manually customized any default Vibe templates, 
back up the files you have modified before performing the interface reset. This applies only to default 
templates that you have modified; templates that you have created are not affected. 


1 Log in to the Vibe site as the Vibe administrator. 


2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 


Console icon E. 
3 In the Management section, click Workspace and Folder Templates. 


Workspace and Folder Templates 


CD OD €C € 


Standard Templates 


Discussion - A Discussion folder is useful for creating a forum where users are likely to both create and reply to entries. 


Blog - A blog folder is a forum where entire entries are displayed in reverse chronological order, based on when they were created. Blogs typically provide information on a 
group of authors. Optionally, the blog folder can be configured so that a larger group can make comments on the entries posted by the original author. 


Calendar - A calendar folder is a place to post group events or display other types of entries by date 


Guestbook - A guestbook folder is a simple place that individuals can “sign,” indicating that they have visited a users Personal Workspace. Visitors may also leave comme 
workspace. Comments are displayed in reverse chronological order. A picture of the individual signing the guestbook is displayed with the comment. The guestbook is ust 


Files - A file folder is a place to put files. Comments or entire discussions can be posted about individual files. Additionally, the files can be automatically locked, edited-in- 
the file. A file folder can emulate a WebDAV server. This allows a user to add and delete files via any WebDAV client, such as the MS Windows File Manager. 


Milestones - A milestone folder is used to roll up or summarize activity in one or more Task folders 


Micro-Blog - A micro-blog folder is a special folder that gets created automatically for each user. Itis intended to contain short text entries only. Each user can add micro-bli 
page. While you can create multiple micro-blog folders, only the one that is created automatically will be accessed as the users real micro-blog. 


Mirrored Files - A mirrored file folder is a special type of file folder where it uses a server file system directory as its file storage area instead of the normal Vibe repository. ` 
via normal file sharing mechanisms. Vibe attempts to keep its knowledge about the folder contents in synch with whatever is in the directory. The mirrored folder feature ca 


4 Click Reset. 
5 Click OK to confirm, then click Close. 


Your Vibe 3.4 site is now ready for use. 
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Updating From Novell Vibe 3.2 to Novell 
Vibe 3.3 


This section describes how to update from Novell Vibe 3.2 to Novell Vibe 3.3. If you are updating from 
a version of Vibe prior to Vibe 3 (Vibe versions prior to Vibe 3 are called Novell Teaming), you must 
first update to Vibe 3 before you can update to Vibe 3.3. For information on how to update to Novell 
Vibe 3, see “Update” in the Novell Vibe OnPrem 3 Installation Guide (http://www.novell.com/ 
documentation/vibe_onprem3/vibeprem3_inst/data/bookinfo.html). 


After you update your Vibe system, ensure that you check the Vibe download site where you 
downloaded the Vibe software for any hot patches that might be available. 


* Section 21.1, “Understanding the Update Process,” on page 181 

* Section 21.2, “Updating a Single-Server System from Vibe 3.2 to Vibe 3.3,” on page 182 
* Section 21.3, “Updating a Multiple-Server System from Vibe 3.2 to Vibe 3.3,” on page 184 
* Section 21.4, “Performing Post-Update Tasks,” on page 186 


21.1 Understanding the Update Process 


During the update from Novell Vibe 3.2 to Vibe 3.3, the following aspects of your Vibe system are 
modified: 


* The software is updated from Vibe 3.2 to Vibe 3.3. 


+ A backup copy of your existing Vibe 3.2 installation is created in the following directory: 


Linux: /opt /novell/teaming/teaming-backup 


Windows: C:\Program Files\Novell\Teaming\teaming-backup 


If your original Vibe system began with version 1.0 (this version of Novell Vibe is called Novell 
Teaming), the backup copy is located in the following directory: 


Linux: /opt/icecore 


Windows: C:\Program Files\icecore 
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21.2 Updating a Single-Server System from Vibe 3.2 to 
Vibe 3.3 


When you update a single-server Novell Vibe installation from Vibe 3.2 to Vibe 3.3, you need to 
update the Vibe software and the Vibe database separately. You can update the software and 
database in whichever order you prefer. 

¢ Section 21.2.1, “Backing Up Vibe Data,” on page 182 

¢ Section 21.2.2, “Updating the Vibe Database from 3.2 to 3.3,” on page 182 

* Section 21.2.3, “Updating the Vibe Software,” on page 183 


21.2.1 Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


21.2.2 Updating the Vibe Database from 3.2 to 3.3 


When you update to Vibe 3.3, the Vibe Installation program does not update the database as part of 
the Vibe software update. Therefore, you must manually run the database update script after you 
have stopped Vibe: 

1 Ensure that you have a current backup of your Vibe 3.2 system. 

2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.2 system. 


4 Change to the directory where the Vibe 3.3 installation program is located. 
5 Unzip the teaming-3.3.n-sql.zip file to create the update-3.2.0-3.3.n directory 


The update-3.2.0-3.3.n directory contains an update script for each type of database 
(MySQL, Microsoft SQL, and Oracle). 


6 Use the database utility for your database type to run the script: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 


Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 


SQL: 
You can also use the script with the SQL Server Express Utility (http://\www.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 

Oracle: sqlplus "/ as sysdba" 


SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit; 


7 Continue with Section 21.2.3, “Updating the Vibe Software,” on page 183. 
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21.2.3 Updating the Vibe Software 


1 Ensure that you have a current backup of your Vibe 3.2 system. 
2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.2 system. 


4 Copy the installer.xml file from the directory where the Vibe 3.2 Installation program is 
located to the directory where you have extracted the Vibe 3.3 software. 


The installer.xml file provides default values when you run the Vibe 3.3 Installation program. 
5 Start the Vibe 3.3 installation program. 


If you need assistance with this task, see the detailed installation instructions for the platform 
where you are updating Vibe: 


* Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63 
* Section 4.2.2, “Running the Windows Vibe Installation Program,” on page 71 


6 Accept the License Agreement, then click Next. 


Novell Vibe 3 Installation Program 


Installation Options 


Select the action you want to perform. 


C New installation 
‘* Update software and settings 


© Reconfigure settings 


Because you provided your Vibe 3.2 installer .xm1 file in the directory with the Vibe 3.3 
installation program, the Update software and settings installation option is selected by default. 


7 Click Next to continue. 
8 Click Yes to let the Installation program know that you have stopped Vibe. 


9 Select the check box to let the installation program know that you have backed up all of your 
data, then click Next. 


10 Select Basic or Advanced, depending on the type of Vibe installation you are updating, then click 
Next. 


For more information about the differences between basic and advanced installations, see 
Section 3.1, “What Is a Basic Vibe Installation?,” on page 35 and Section 9.1, “What Is an 
Advanced Installation?,” on page 95. 


11 Continue through the installation process, retaining or changing configuration information 
depending on the needs of your Vibe 3.3 system. 


12 Click Install when you are ready to perform the update. 
13 Click Finish when the update is completed. 


14 If you have not yet updated the Vibe database, complete Section 21.2.2, “Updating the Vibe 
Database from 3.2 to 3.3,” on page 182 before you start Vibe. 


15 Start Vibe 3.3 in the same way that you have been starting Vibe 3.2. 


When you start Vibe for the first time after the update, it takes longer to start than usual because 
data in the Vibe database must be updated before the Vibe site is ready to use. 
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21.3 


21.3.1 


21.3.2 


Updating a Multiple-Server System from Vibe 3.2 
to Vibe 3.3 


If your Novell Vibe 3.2 system is distributed across multiple servers, the Vibe 3.3 installation program 
can update Vibe components on the Vibe server, but you must manually update any Vibe 
components that you have placed on remote servers. 

¢ Section 21.3.1, “Backing Up Vibe Data,” on page 184 

* Section 21.3.2, “Manual Vibe Database Update,” on page 184 

* Section 21.3.3, “Remote Lucene Index Server Update,” on page 185 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Manual Vibe Database Update 


To update a database from Vibe 3.2 to 3.3, you must run the Vibe 3.3 database update script. 


1 Stop Vibe. 


2 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.2 system. 


3 Change to the directory where the Vibe 3.3 installation program is located. 
4 Unzip the teaming-3.3.n-sql.zip file to create the update-3.2.0-3.3.ndirectory. 


The update-3.2.0-3.3.n directory contains an update script for each type of database 
(MySQL, Microsoft SQL, and Oracle). 


5 Copy the script for your database type to the server where the Vibe database is located. 


6 (Conditional) If you have multiple Oracle databases, you must edit the update-oracle.sql 
script and add @database_name to the first line of the script. For example, connect sitescape/ 
sitescape@vibe. 


7 Use the database client utility for your database type to run the script: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 


Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 


SQL: 
You can also use the script with the SQL Server Express Utility (http://www.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 

Oracle: sqlplus "/ as sysdba" 


SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit; 


8 After you have updated the database from Vibe 3.2 to Vibe 3.3: 
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If your Lucene Index Server is also on a remote server, continue with Section 21.3.3, “Remote 
Lucene Index Server Update,” on page 185. 


or 


If all remaining components that need to be updated from Vibe 3.2 to Vibe 3.3 are on the Vibe 
server, follow the instructions in Section 21.2, “Updating a Single-Server System from Vibe 3.2 to 
Vibe 3.3,” on page 182. 


21.3.3 Remote Lucene Index Server Update 


To update your index from Novell Vibe 3.2 to Novell Vibe 3.3 when the Vibe installation program 
cannot do it for you, you need to run the Remote Lucene Server installation program. 


1 


Stop Vibe. 


2 Stop the Lucene Index Server. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
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Vibe 3.2 system. 


Copy the Vibe 3.3 Remote Lucene Server Installation program from the directory where the Vibe 
3.3 Installation program is located to a convenient directory on the server where the remote 
Lucene Index Server is located. 


The name of the Remote Lucene Server Installation program varies by platform: 


Linux: lucene-installer.linux 


Windows: lucene-installer.exe 


Start the Vibe 3.3 Remote Lucene Server installation program. 

Accept the License Agreement, then click Next. 

Select Update software and settings. 

Click Next to continue. 

Click Next to accept the installation location. 

Click Next to accept the Java JDK location. 

In the Host field, specify the hostname where you are installing the remote Lucene Index Server. 
Change Lucene configuration settings as needed, then click Next. 


For information about Lucene configuration settings, see Section 9.6.2, “Changing Lucene 
Configuration Settings,” on page 100. 


Click Install to install the updated Lucene Index Server software. 
Click Finish when the update is completed. 
Start the Lucene Index Server. 


Now that all remote Vibe components have been updated, follow the instructions in Section 21.2, 
“Updating a Single-Server System from Vibe 3.2 to Vibe 3.3,” on page 182. 
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21.4 


21.4.1 


Performing Post-Update Tasks 


After you start Novell Vibe 3.3, you can access your Vibe site as usual. However, you need to reset 
some aspects of the interface before you allow users to access the updated site. The interface reset 
affects only those definitions and templates that are included with the Vibe product. If you have 
created custom definitions and templates, they are unaffected by the interface reset. 

* Section 21.4.1, “Resetting the Search Index,” on page 186 

¢ Section 21.4.2, “Resetting Your Definitions,” on page 187 


¢ Section 21.4.3, “Resetting the Standard Templates,” on page 187 


Resetting the Search Index 


There have been no modifications to search functionality in Vibe 3.3. However, if you missed some of 
the changes from previous releases, you might want to re-index the search index. 


The steps to reset the search index differ depending on whether you have multiple Lucene Index 
servers. For more information about multiple search indexes, see Chapter 16, “Running Multiple 
Lucene Index Servers,” on page 147. 


Depending on the size of your Vibe site, this can be a very time-consuming process. 


* “Resetting a Single Search Index” on page 186 
* “Resetting the Search Index with Multiple Index Servers” on page 186 


Resetting a Single Search Index 


1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon [EM in the upper right corner of the page, then click the Administration 
Console icon E 

3 In the Management section, click Search Index. 

4 Select Re-Index Everything. 

5 Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


A message notifies you when indexing is complete. 


Resetting the Search Index with Multiple Index Servers 


1 Login to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon EG 

In the Search Index section, click Index. 

Select Re-Index Everything. 

Select each node that you want to re-index. 

Click OK, then click Close. 
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Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


A message notifies you when indexing is complete. 


21.4.2 Resetting Your Definitions 


In Vibe 3.3, two changes were made to the User Profile definition: the Phone element was added and 
the Conferencing Name and Conferencing Password elements were removed. It is likely that neither 
of these changes are critical for your Vibe site. However, if you do want to see these changes on your 
Vibe site, you can complete the steps in this section, or add the elements manually to your User 
Profile definition. 


WARNING: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe definitions. If you want to save any modified definitions before proceeding, 
you can export the modified definitions. Also, you might want to document exactly what changes you 
have made in order to make it easier to reconstruct the definition after you reset it. This applies only 
to definitions that you have modified; definitions that you have created are not affected. 


To reset your Vibe definitions: 

1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon EG 

3 In the System section, click Form/View Designers to display the Form and View Designers page. 

4 Click Reset. 
The Reset Definitions page is displayed. 

5 Click Select All. 
You can expand each definition to ensure that all definitions have been selected. 

6 Click OK. 


21.43 Resetting the Standard Templates 


There have been no modifications to Vibe templates in Vibe 3.3. However, if you missed some of the 
changes from previous releases, you might want to reset the definitions. 


IMPORTANT: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe templates. If you have manually customized any default Vibe templates, 
back up the files you have modified before performing the interface reset. This applies only to default 
templates that you have modified; templates that you have created are not affected. 


1 Login to the Vibe site as the Vibe administrator. 
2 Click the Settings icon [EB in the upper right corner of the page, then click the Administration 


Console icon E 
3 In the Management section, click Workspace and Folder Templates. 
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Workspace and Folder Templates 
«» 


Standard Templates 


= Discussion -A Discussion folder is useful for creating a forum where users are likely to both create and reply to entries. 


= Biog -A blog folder is a forum where entire entries are displayed in reverse chronological order, based on when they were created. Blogs typically provide information ona 
group of authors. Optionally, the blog folder can be configured so that a larger group can make comments on the entries posted by the original author. 


= Calendar - A calendar folder is a place to post group events or display other types of entries by date. 


= Guestbook - A guestbook folder is a simple place that individuals can "sign," indicating that they have visited a users Personal Workspace. Visitors may also leave comme 
workspace. Comments are displayed in reverse chronological order. A picture of the individual signing the guestbook is displayed with the comment. The guestbook is ust 


= Files - A file folder is a place to put files. Comments or entire discussions can be posted about individual files. Additionally, the files can be automatically locked, edited-in-p 
the file. A file folder can emulate a WebDAV server. This allows a user to add and delete files via any WebDAV client, such as the MS Windows File Manager. 


= Milestones - A milestone folder is used to roll up or summarize activity in one or more Task folders. 


= Micro-Blog - A micro-blog folder is a special folder that gets created automatically for each user. Itis intended to contain short text entries only. Each user can add micro-bli 
page. While you can create multiple micro-blog folders, only the one that is created automatically will be accessed as the users real micro-blog. 


= Mirrored Files - A mirrored file folder is a special type of file folder where it uses a server file system directory as its file storage area instead of the normal Vibe repository. ` 
via normal file sharing mechanisms. Vibe attempts to keep its knowledge about the folder contents in synch with whatever is in the directory. The mirrored folder feature ca 


4 Click Reset. 
5 Click OK to confirm, then click Close. 


Your Vibe 3.3 site is now ready for use. 
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Updating From Novell Vibe 3.1 to Novell 
Vibe 3.3 


This section describes how to update from Novell Vibe 3.1 to Novell Vibe 3.3. If you are updating from 
a version of Vibe prior to Vibe 3 (Vibe versions prior to Vibe 3 are called Novell Teaming), you must 
first update to Vibe 3 before you can update to Vibe 3.3. For information on how to update to Novell 
Vibe 3, see “Update” in the Novell Vibe OnPrem 3 Installation Guide (http://www.novell.com/ 
documentation/vibe_onprem3/vibeprem3_inst/data/bookinfo.html). 


After you update your Vibe system, ensure that you check the Vibe download site where you 
downloaded the Vibe software for any hot patches that might be available. 


* Section 22.1, “Understanding the Update Process,” on page 189 

* Section 22.2, “Updating a Single-Server System from Vibe 3.1 to Vibe 3.3,” on page 190 
* Section 22.3, “Updating a Multiple-Server System from Vibe 3.1 to Vibe 3.3,” on page 192 
* Section 22.4, “Performing Post-Update Tasks,” on page 194 


22.1 Understanding the Update Process 


During the update from Novell Vibe 3.1 to Vibe 3.3, the following aspects of your Vibe system are 
modified: 


* The software is updated from Vibe 3.1 to Vibe 3.3. 


+ A backup copy of your existing Vibe 3.1 installation is created in the following directory: 


Linux: /opt /novell/teaming/teaming-backup 


Windows: C:\Program Files\Novell\Teaming\teaming-backup 


If your original Vibe system began with version 1.0 (this version of Novell Vibe is called Novell 
Teaming), the backup copy is located in the following directory: 


Linux: /opt/icecore 


Windows: C:\Program Files\icecore 
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22.2 Updating a Single-Server System from Vibe 3.1 to 
Vibe 3.3 


When you update a single-server Novell Vibe installation from Vibe 3.1 to Vibe 3.3, you need to 
update the Vibe software and the Vibe database separately. You can update the software and 
database in whichever order you prefer. 

¢ Section 22.2.1, “Backing Up Vibe Data,” on page 190 

¢ Section 22.2.2, “Updating the Vibe Database from 3.1 to 3.3,” on page 190 

¢ Section 22.2.3, “Updating the Vibe Software,” on page 191 


22.2.1 Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


22.2.2 Updating the Vibe Database from 3.1 to 3.3 


When you update to Vibe 3.3, the Vibe Installation program does not update the database as part of 
the Vibe software update. Therefore, you must manually run the database update script after you 
have stopped Vibe: 

1 Ensure that you have a current backup of your Vibe 3.1 system. 

2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.1 system. 


4 Change to the directory where the Vibe 3.3 installation program is located. 


5 Unzip the teaming-3.3.n-sql.zip file to create the update-3.1.0-3.2.n directory and the 
update-3.2.0-3.3.n directory. 


The update-3.1.0-3.2.n directory and the update-3.2.0-3.3.n directory contain an update 
script for each type of database (MySQL, Microsoft SQL, and Oracle). 


6 Use the database utility for your database type to run the corresponding script from both the 
update-3.1.0-3.2.ndirectory and the update-3.2.0-3.3.n directory: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 


Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 


SQL: 
You can also use the script with the SQL Server Express Utility (http://www.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 

Oracle: sqlplus "/ as sysdba" 


SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit; 


190 Novell Vibe 3.4 Installation Guide 


NOTE: You must run each database update script in the correct order: first run the update script 
for Vibe 3.1 to 3.2, then run the script for Vibe 3.2 to Vibe 3.3. 


7 Continue with Section 22.2.3, “Updating the Vibe Software,” on page 191. 


22.2.3 Updating the Vibe Software 


1 Ensure that you have a current backup of your Vibe 3.1 system. 
2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.1 system. 


4 Copy the installer.xml file from the directory where the Vibe 3.1 Installation program is 
located to the directory where you have extracted the Vibe 3.3 software. 


The installer.xml file provides default values when you run the Vibe 3.3 Installation program. 
5 Start the Vibe 3.3 installation program. 


If you need assistance with this task, see the detailed installation instructions for the platform 
where you are updating Vibe: 


* Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63 
* Section 4.2.2, “Running the Windows Vibe Installation Program,” on page 71 


6 Accept the License Agreement, then click Next. 


Novell Vibe 3 Installation Program 


Installation Options 


Select the action you want to perform. 


C New installation 
© Update software and settings 
C Reconfigure settings 


Because you provided your Vibe 3.1 installer .xm1 file in the directory with the Vibe 3.3 
installation program, the Update software and settings installation option is selected by default. 


7 Click Next to continue. 
8 Click Yes to let the Installation program know that you have stopped Vibe. 


9 Select the check box to let the installation program know that you have backed up all of your 
data, then click Next. 


10 Select Basic or Advanced, depending on the type of Vibe installation you are updating, then click 
Next. 


For more information about the differences between basic and advanced installations, see 
Section 3.1, “What Is a Basic Vibe Installation?,” on page 35 and Section 9.1, “What Is an 
Advanced Installation?,” on page 95. 


11 Continue through the installation process, retaining or changing configuration information 
depending on the needs of your Vibe 3.3 system. 


12 Click Install when you are ready to perform the update. 
13 Click Finish when the update is completed. 


14 If you have not yet updated the Vibe database, complete Section 22.2.2, “Updating the Vibe 
Database from 3.1 to 3.3,” on page 190 before you start Vibe. 
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22.3 


22.3.1 


22.3.2 


15 Start Vibe 3.3 in the same way that you have been starting Vibe 3.1. 


When you start Vibe for the first time after the update, it takes longer to start than usual because 
data in the Vibe database must be updated before the Vibe site is ready to use. 


Updating a Multiple-Server System from Vibe 3.1 
to Vibe 3.3 


If your Novell Vibe 3.1 system is distributed across multiple servers, the Vibe 3.3 installation program 
can update Vibe components on the Vibe server, but you must manually update any Vibe 
components that you have placed on remote servers. 

¢ Section 22.3.1, “Backing Up Vibe Data,” on page 192 

* Section 22.3.2, “Manual Vibe Database Update,” on page 192 

* Section 22.3.3, “Remote Lucene Index Server Update,” on page 193 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Manual Vibe Database Update 


To update a database from Vibe 3.1 to 3.3, you must run the Vibe 3.3 database update script. 


1 Stop Vibe. 


2 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.1 system. 


3 Change to the directory where the Vibe 3.3 installation program is located. 


4 Unzip the teaming-3.3.n-sql.zip file to create the update-3.1.0-3.2.n directory and the 
update-3.2.0-3.3.n directory. 


The update-3.1.0-3.2.n directory and the update-3.2.0-3.3.n directory contain an update 
script for each type of database (MySQL, Microsoft SQL, and Oracle). 


5 Copy the script for your database type to the server where the Vibe database is located. 


6 (Conditional) If you have multiple Oracle databases, you must edit the update-oracle.sql 
script and add @database_name to the first line of the script. For example, connect sitescape/ 
sitescape@vibe. 


7 Use the database utility for your database type to run the corresponding script from both the 
update-3.1.0-3.2.ndirectory and the update-3.2.0-3.3.n directory: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 


Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 

SQL: 
You can also use the script with the SQL Server Express Utility (http:/Awww.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 
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Oracle: sqlplus "/ as sysdba" 
SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit; 
8 After you have updated the database from Vibe 3.1 to Vibe 3.3: 


If your Lucene Index Server is also on a remote server, continue with Section 22.3.3, “Remote 
Lucene Index Server Update,” on page 193. 


or 


If all remaining components that need to be updated from Vibe 3.1 to Vibe 3.3 are on the Vibe 
server, follow the instructions in Section 22.2, “Updating a Single-Server System from Vibe 3.1 to 
Vibe 3.3,” on page 190. 


22.3.3 Remote Lucene Index Server Update 


To update your index from Novell Vibe 3.1 to Novell Vibe 3.3 when the Vibe installation program 
cannot do it for you, you need to run the Remote Lucene Server installation program. 

1 Stop Vibe. 

2 Stop the Lucene Index Server. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3.1 system. 


4 Copy the Vibe 3.3 Remote Lucene Server Installation program from the directory where the Vibe 
3.3 Installation program is located to a convenient directory on the server where the remote 
Lucene Index Server is located. 


The name of the Remote Lucene Server Installation program varies by platform: 


Linux: lucene-installer.linux 


Windows: lucene-installer.exe 


Start the Vibe 3.3 Remote Lucene Server installation program. 
Accept the License Agreement, then click Next. 
Select Update software and settings. 


Click Next to continue. 
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Click Next to accept the installation location. 

10 Click Next to accept the Java JDK location. 

11 In the Host field, specify the hostname where you are installing the remote Lucene Index Server. 
12 Change Lucene configuration settings as needed, then click Next. 


For information about Lucene configuration settings, see Section 9.6.2, “Changing Lucene 
Configuration Settings,” on page 100. 


13 Click Install to install the updated Lucene Index Server software. 
14 Click Finish when the update is completed. 
15 Start the Lucene Index Server. 


16 Now that all remote Vibe components have been updated, follow the instructions in Section 22.2, 
“Updating a Single-Server System from Vibe 3.1 to Vibe 3.3,” on page 190. 
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22.4 


22.4.1 


22.4.2 


Performing Post-Update Tasks 


After you start Novell Vibe 3.3, you can access your Vibe site as usual. However, you need to reset 
some aspects of the interface before you allow users to access the updated site. The interface reset 
affects only those definitions and templates that are included with the Vibe product. If you have 
created custom definitions and templates, they are unaffected by the interface reset. 


* Section 22.4.1, “Resetting Your Definitions,” on page 194 
* Section 22.4.2, “Resetting the Search Index,” on page 194 
* Section 22.4.3, “Resetting the Standard Templates,” on page 195 


Resetting Your Definitions 


Various aspects of the Vibe interface have been redesigned and enhanced since Vibe 3.1. Some of 
these enhancements affect entries, folders, user profiles, and user workspaces. If you have made 
customizations to these areas of Vibe, you must reset these definitions in order to see the 
enhancements, as described in this section. 


WARNING: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe definitions. If you want to save any modified definitions before proceeding, 
you can export the modified definitions. Also, you might want to document exactly what changes you 
have made in order to make it easier to reconstruct the definition after you reset it. This applies only 
to definitions that you have modified; definitions that you have created are not affected. 


To reset your Vibe definitions: 

1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon EG 

3 In the System section, click Form/View Designers to display the Form and View Designers page. 

4 Click Reset. 
The Reset Definitions page is displayed. 

5 Click Select All. 
You can expand each definition to ensure that all definitions have been selected. 

6 Click OK. 


Resetting the Search Index 


Search functionality has been improved since Vibe 3.1. For optimal search performance, you need to 
re-index the search index after you update to Vibe 3.3. 


The steps to reset the search index differ depending on whether you have multiple Lucene Index 
servers. For more information about multiple search indexes, see Chapter 16, “Running Multiple 
Lucene Index Servers,” on page 147. 


Depending on the size of your Vibe site, this can be a very time-consuming process. 


* “Resetting a Single Search Index” on page 195 
* “Resetting the Search Index with Multiple Index Servers” on page 195 
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22.4.3 


Resetting a Single Search Index 


1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon in the upper right corner of the page, then click the Administration 
Console icon E 

3 In the Management section, click Search Index. 

4 Select Re-Index Everything. 

5 Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


A message notifies you when indexing is complete. 


Resetting the Search Index with Multiple Index Servers 


1 Login to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon E. 

In the Search Index section, click Index. 

Select Re-Index Everything. 

Select each node that you want to re-index. 

Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 
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A message notifies you when indexing is complete. 
Resetting the Standard Templates 


IMPORTANT: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe templates. If you have manually customized any default Vibe templates, 
back up the files you have modified before performing the interface reset. This applies only to default 
templates that you have modified; templates that you have created are not affected. 


1 Log in to the Vibe site as the Vibe administrator. 
2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 


Console icon E. 
3 In the Management section, click Workspace and Folder Templates. 
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Workspace and Folder Templates 
«» 


Standard Templates 


= Discussion -A Discussion folder is useful for creating a forum where users are likely to both create and reply to entries. 


= Biog -A blog folder is a forum where entire entries are displayed in reverse chronological order, based on when they were created. Blogs typically provide information ona 
group of authors. Optionally, the blog folder can be configured so that a larger group can make comments on the entries posted by the original author. 


= Calendar - A calendar folder is a place to post group events or display other types of entries by date. 


= Guestbook - A guestbook folder is a simple place that individuals can "sign," indicating that they have visited a users Personal Workspace. Visitors may also leave comme 
workspace. Comments are displayed in reverse chronological order. A picture of the individual signing the guestbook is displayed with the comment. The guestbook is ust 


= Files - A file folder is a place to put files. Comments or entire discussions can be posted about individual files. Additionally, the files can be automatically locked, edited-in-p 
the file. A file folder can emulate a WebDAV server. This allows a user to add and delete files via any WebDAV client, such as the MS Windows File Manager. 


= Milestones - A milestone folder is used to roll up or summarize activity in one or more Task folders. 


= Micro-Blog - A micro-blog folder is a special folder that gets created automatically for each user. Itis intended to contain short text entries only. Each user can add micro-bli 
page. While you can create multiple micro-blog folders, only the one that is created automatically will be accessed as the users real micro-blog. 


= Mirrored Files - A mirrored file folder is a special type of file folder where it uses a server file system directory as its file storage area instead of the normal Vibe repository. ` 
via normal file sharing mechanisms. Vibe attempts to keep its knowledge about the folder contents in synch with whatever is in the directory. The mirrored folder feature ca 


4 Click Reset. 
5 Click OK to confirm, then click Close. 


Your Vibe 3.3 site is now ready for use. 
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23.1 


Updating from Novell Vibe 3 to Novell 
Vibe 3.3 


This section describes how to update from Novell Vibe 3 to Novell Vibe 3.3. If you are updating froma 
version of Vibe prior to Vibe 3 (Vibe versions prior to Vibe 3 are called Novell Teaming), you must first 
update to Vibe 3 before you can update to Vibe 3.3. For information on how to update to Novell Vibe 


3, see “Update” in the Novell Vibe OnPrem 3 Installation Guide (http://www.novell.com/ 
documentation/vibe_onprem3/vibeprem3_inst/data/bookinfo.html). 


After you update your Vibe system, ensure that you check the Vibe download site where you 
downloaded the Vibe software for any hot patches that might be available. 


* Section 23.1, “Understanding the Update Process,” on page 197 

* Section 23.2, “Updating a Single-Server System from Vibe 3 to Vibe 3.3,” on page 198 
* Section 23.3, “Updating a Multiple-Server System from Vibe 3 to Vibe 3.3,” on page 200 
* Section 23.4, “Performing Post-Update Tasks,” on page 202 


Understanding the Update Process 


During the update from Novell Vibe 3 to Vibe 3.3, the following aspects of your Vibe system are 
modified: 


* The software is updated from Vibe 3 to Vibe 3.3. 


+ A backup copy of your existing Vibe 3 installation is created in the following directory: 


Linux: /opt/novell/teaming/teaming-backup 


Windows: C:\Program Files\Novell\Teaming\teaming-backup 


If your original Vibe system began with version 1.0 (this version of Novell Vibe is called Novell 


Teaming), the backup copy is located in the following directory: 


Linux: /opt/icecore 


Windows: C:\Program Files\icecore 
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23.2 


23.2.1 


23.2.2 


Updating a Single-Server System from Vibe 3 to 
Vibe 3.3 


When you update a single-server Novell Vibe installation from Vibe 3 to Vibe 3.3, you need to update 
the Vibe software and the Vibe database separately. You can update the software and database in 
whichever order you prefer. 

¢ Section 23.2.1, “Backing Up Vibe Data,” on page 198 

* Section 23.2.2, “Updating the Vibe Database,” on page 198 

¢ Section 23.2.3, “Updating the Vibe Software,” on page 199 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Updating the Vibe Database 


When you update to Vibe 3.3, the Vibe Installation program does not update the database as part of 
the Vibe software update. Therefore, you must manually run the database update scripts after you 
have stopped Vibe: 

1 Ensure that you have a current backup of your Vibe 3 system. 

2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3 system. 


4 Change to the directory where the Vibe 3.3 installation program is located. 


5 Unzip the teaming-3.3.n-sql.zip file to create the update-3.0.0-3.1.n, update-3.1.0- 
3.2.n, and update-3.2.0-3.3.n directories. 


The update-3.0.0-3.1.0, update-3.1.0-3.2.nand update-3.2.0-3.3.n directories contain 
update scripts for each type of database (MySQL, Microsoft SQL, and Oracle). 


6 Use the database utility for your database type to run the corresponding script for your database 
from the update-3.0.0-3.1.0, update-3.1.0-3.2.nand update-3.2.0-3.3.n directories: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 


Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 


SQL: 
You can also use the script with the SQL Server Express Utility (http://www.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 

Oracle: sqlplus "/ as sysdba" 


SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit; 
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NOTE: You must run each database update script in the correct order: first run the update script 
for Vibe 3 to 3.1, then run the script for Vibe 3.1 to Vibe 3.2, then run the script for Vibe 3.2 to 
Vibe 3.3. 


7 Continue with Section 22.2.3, “Updating the Vibe Software,” on page 191. 


23.2.3 Updating the Vibe Software 


1 Make sure you have a current backup of your Vibe 3 system. 
2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3 system. 


4 Copy the installer.xml1 file from the directory where the Vibe 3 Installation program is located 
to the directory where you have extracted the Vibe 3.3 software. 


The installer.xml file provides default values when you run the Vibe 3.3 Installation program. 
5 Start the Vibe 3.3 installation program. 


If you need assistance with this task, see the detailed installation instructions for the platform 
where you are updating Vibe: 


* Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63 
* Section 4.2.2, “Running the Windows Vibe Installation Program,” on page 71 


6 Accept the License Agreement, then click Next. 


Novell Vibe 3 Installation Program 


Installation Options 


Select the action you want to perform. 


C New installation 
© Update software and settings 
© Reconfigure settings 


Because you provided your Vibe 3 installer.xml file in the directory with the Vibe 3.3 
installation program, the Update software and settings installation option is selected by default. 


7 Click Next to continue. 
8 Click Yes to let the Installation program know that you have stopped Vibe. 


9 Select the check box to let the installation program know that you have backed up all of your 
data, then click Next. 


10 Select Basic or Advanced, depending on the type of Vibe installation you are updating, then click 
Next. 


For more information about the differences between basic and advanced installations, see 
Section 3.1, “What Is a Basic Vibe Installation?,” on page 35 and Section 9.1, “What Is an 
Advanced Installation?,” on page 95. 


11 Continue through the installation process, retaining or changing configuration information 
depending on the needs of your Vibe 3.3 system. 


12 Click Install when you are ready to perform the update. 


13 Click Finish when the update is completed. 
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23.3 


23.3.1 


23.3.2 


14 If you have not yet updated the Vibe database, complete Section 22.2.2, “Updating the Vibe 
Database from 3.1 to 3.3,” on page 190 before you start Vibe. 


15 Start Vibe 3.3 in the same way that you have been starting Vibe 3. 


When you start Vibe for the first time after the update, it takes longer to start than usual because 
data in the Vibe database must be updated before the Vibe site is ready to use. 


Updating a Multiple-Server System from Vibe 3 to 
Vibe 3.3 


If your Novell Vibe 3 system is distributed across multiple servers, the Vibe 3.3 installation program 
can update Vibe components on the Vibe server, but you must manually update any Vibe 
components that you have placed on remote servers. 

* Section 23.3.1, “Backing Up Vibe Data,” on page 200 

* Section 23.3.2, “Manual Vibe Database Update,” on page 200 


* Section 23.3.3, “Remote Lucene Index Server Update,” on page 201 


Backing Up Vibe Data 


Ensure that your Vibe data is backed up before you begin the update process. For information about 
the data that needs to be backed up, see “Backing Up Vibe Data” in the Novell Vibe 3.4 
Administration Guide. 


Manual Vibe Database Update 


To update a database from Vibe 3 to 3.3, you must run the Vibe 3.2 database update scripts. 


1 Ensure that you have a current backup of your Vibe 3 system. 
2 Stop Vibe. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3 system. 


4 Change to the directory where the Vibe 3.3 installation program is located. 


5 Unzip the teaming-3.3.n-sql.zip file to create the update-3.0.0-3.1.n, update-3.1.0- 
3.2.n, and update-3.2.0-3.3.n directories. 


The update-3.0.0-3.1.0, update-3.1.0-3.2.nand update-3.2.0-3.3.ndirectories contain 
update scripts for each type of database (MySQL, Microsoft SQL, and Oracle). 


6 Copy the scripts for your database type to the server where the Vibe database is located. 


7 (Conditional) If you have multiple Oracle databases, you must edit the update-oracle.sql 
scripts in each directory and add @database name to the first line of the scripts. For example, 
connect sitescape/sitescape@vibe. 


8 Use the database utility for your database type to run the corresponding script for your database 
from the update-3.0.0-3.1.0, update-3.1.0-3.2.n and update-3.2.0-3.3.n directories: 


MySQL: mysql -uusername -ppassword < "/path/update-mysql.sql" 
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Microsoft osql -Uusername -Ppassword -i update-sqlserver.sql 


SQL: 
You can also use the script with the SQL Server Express Utility (http:/Awww.microsoft.com/ 
downloads/details.aspx?familyid=fa87e828-173f-472e-a85c- 
27ed01cf6b02&displaylang=en) to update the database. 

Oracle: sqlplus "/ as sysdba" 


SQL>spool update-oracle.out; 
SQL>@update-oracle 
SQL>quit ; 


NOTE: You must run each database update script in the correct order: first run the update script 
for Vibe 3 to 3.1, then run the script for Vibe 3.1 to Vibe 3.2, then run the script for Vibe 3.2 to 
Vibe 3.3. 


9 After you have updated the database from Vibe 3 to Vibe 3.3: 


If your Lucene Index Server is also on a remote server, continue with Section 22.3.3, “Remote 
Lucene Index Server Update,” on page 193. 


or 


If all remaining components that need to be updated from Vibe 3 to Vibe 3.3 are on the Vibe 
server, follow the instructions in Section 23.2, “Updating a Single-Server System from Vibe 3 to 
Vibe 3.3,” on page 198. 


23.3.3 Remote Lucene Index Server Update 


To update your index from Novell Vibe 3.0 to Novell Vibe 3.3 when the Vibe installation program 
cannot do it for you, you need to run the Remote Lucene Server installation program. 

1 Stop Vibe. 

2 Stop the Lucene Index Server. 


3 Ensure that no application (such as a command prompt or Windows Explorer) is running on the 
Vibe 3 system. 


4 Copy the Vibe 3.3 Remote Lucene Server Installation program from the directory where the Vibe 
3.3 Installation program is located to a convenient directory on the server where the remote 
Lucene Index Server is located. 


The name of the Remote Lucene Server Installation program varies by platform: 


Linux: lucene-installer.linux 


Windows: lucene-installer.exe 


Start the Vibe 3.3 Remote Lucene Server installation program. 
Accept the License Agreement, then click Next. 
Select Update software and settings. 


Click Next to continue. 
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Click Next to accept the installation location. 
10 Click Next to accept the Java JDK location. 
11 In the Host field, specify the hostname where you are installing the remote Lucene Index Server. 


12 Change Lucene configuration settings as needed, then click Next. 
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For information about Lucene configuration settings, see Section 9.6.2, “Changing Lucene 
Configuration Settings,” on page 100. 


13 Click Install to install the updated Lucene Index Server software. 
14 Click Finish when the update is completed. 
15 Start the Lucene Index Server. 


16 Now that all remote Vibe components have been updated, follow the instructions in Section 22.2, 
“Updating a Single-Server System from Vibe 3.1 to Vibe 3.3,” on page 190. 


Performing Post-Update Tasks 


After you start Novell Vibe 3.3, you can access your Vibe site as usual. However, you need to reset 
some aspects of the interface before you allow users to access the updated site. The interface reset 
affects only those definitions and templates that are included with the Vibe product. If you have 
created custom definitions and templates, they are unaffected by the interface reset. 


* Section 23.4.1, “Resetting Your Definitions,” on page 202 


* Section 23.4.2, “Resetting the Search Index,” on page 203 
* Section 23.4.3, “Resetting the Standard Templates,” on page 204 


Resetting Your Definitions 


Various aspects of the Vibe interface have been redesigned and enhanced since Vibe 3. Some of 
these enhancements affect entries, folders, user profiles, and user workspaces. If you have made 
customizations to these areas of Vibe, you must reset these definitions in order to see 
enhancements, as described in this section. 


WARNING: The following procedure deletes any custom modifications that you have previously 
made to the default Vibe definitions. If you want to save any modified definitions before proceeding, 
you can export the modified definitions. Also, you might want to document exactly what changes you 
have made in order to make it easier to reconstruct the definition after you reset it. This applies only 
to definitions that you have modified; definitions that you have created are not affected. 


To reset your Vibe definitions: 


1 Log in to the Vibe site as the Vibe administrator. 
2 Click the Settings icon [EM in the upper right corner of the page, then click the Administration 
Console icon E 
3 In the System section, click Form/View Designers to display the Form and View Designers page. 
4 Click Reset. 
The Reset Definitions page is displayed. 
5 Click Select All. 
You can expand each definition to ensure that all definitions have been selected. 
6 Click OK. 
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23.4.2 Resetting the Search Index 


Search functionality has been improved since Vibe 3. For optimal search performance, you need to 
re-index the search index after you update to Vibe 3.3. 


The steps to reset the search index differ depending on whether you have multiple Lucene Index 
servers. For more information about multiple search indexes, see Chapter 16, “Running Multiple 
Lucene Index Servers,” on page 147. 


Depending on the size of your Vibe site, this can be a very time-consuming process. 


* “Resetting a Single Search Index” on page 203 
* “Resetting the Search Index with Multiple Index Servers” on page 203 


Resetting a Single Search Index 


1 Log in to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EF in the upper right corner of the page, then click the Administration 
Console icon E 

3 In the Management section, click Search Index. 

4 Select Re-Index Everything. 

5 Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 


A message notifies you when indexing is complete. 


Resetting the Search Index with Multiple Index Servers 


1 Login to the Vibe site as the Vibe administrator. 

2 Click the Settings icon EJ in the upper right corner of the page, then click the Administration 
Console icon EG 

In the Search Index section, click Index. 

Select Re-Index Everything. 

Select each node that you want to re-index. 

Click OK, then click Close. 


Users can still access the Vibe site during the indexing process, but search results might not be 
accurate until the index has been completely rebuilt. 
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A message notifies you when indexing is complete. 
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23.4.3 Resetting the Standard Templates 


IMPORTANT: If you have manually customized any templates that are included with the Vibe 
product, back up the files you have modified before performing the interface reset. 


1 Log in to the Vibe site as the Vibe administrator. 
2 Click the Settings icon EJ in the upper right corner of the page, then click the Administration 


Console icon E. 
3 In the Management section, click Workspace and Folder Templates. 


CID GOD CEDE» 


Standard Templates 


= Discussion -A Discussion folder is useful for creating a forum where users are likely to both create and reply to entries. 


= Blog - A blog folder is a forum where entire entries are displayed in reverse chronological order, based on when they were created. Blogs typically provide information on a 
group of authors. Optionally, the blog folder can be configured so that a larger group can make comments on the entries posted by the original author. 


= Calendar -A calendar folder is a place to post group events or display other types of entries by date 


= Guestbook - A guestbook folder is a simple place that individuals can "sign," indicating that they have visited a users Personal Workspace. Visitors may also leave comme 
workspace. Comments are displayed in reverse chronological order. A picture of the individual signing the guestbook is displayed with the comment. The guestbook is ust 


= Files - A file folder is a place to put files. Comments or entire discussions can be posted about individual files. Additionally, the files can be automatically locked, edited-in- 
the file. A file folder can emulate a WebDAV server. This allows a user to add and delete files via any WebDAV client, such as the MS Windows File Manager. 


= Milestones - A milestone folder is used to roll up or summarize activity in one or more Task folders. 


= Micro-Blog - A micro-blog folder is a special folder that gets created automatically for each user. Itis intended to contain short text entries only. Each user can add micro-bli 
page. While you can create multiple micro-blog folders, only the one that is created automatically will be accessed as the users real micro-blog. 


= Mirrored Files - A mirrored file folder is a special type of file folder where it uses a server file system directory as its file storage area instead of the normal Vibe repository. ` 
via normal file sharing mechanisms. Vibe attempts to keep its knowledge about the folder contents in synch with whatever is in the directory. The mirrored folder feature ca 


4 Click Reset. 
5 Click OK to confirm, then click Close. 


Your Vibe 3.3 site is now ready for use. 
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Updating the Operating System Where 
Vibe Is Running 


You can update the operating system where Vibe is running. 


1 Update the Linux or Windows operating system to a version that Vibe supports. 


For information about which versions are supported, see Section 2.2, “Vibe 3.4 Server 
Requirements,” on page 20. 


For information about how to update the operating system, view the appropriate documentation 
for your operating system. 


2 (Conditional) If you updated a Linux server, the TrueType font path that Vibe uses for document 
conversion might be broken after the update. To fix this problem, you need to re-run the Vibe 
installation after upgrading the Linux operating system. 


For information on how to run the Vibe installation, see Section 4.1, “Linux: Installing and Setting 
Up a Basic Vibe Site,” on page 61 for a basic installation, or Chapter 10, “Performing an 
Advanced Vibe Installation,” on page 119 for an advanced installation. 
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Migrate 


* Chapter 25, “Migrating Existing Novell Vibe Data into a New Vibe 3.4 System,” on page 209 
¢ Chapter 26, “Migrating from SiteScape Forum or Other Collaboration Software,” on page 217 
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Migrating Existing Novell Vibe Data into 
a New Vibe 3.4 System 


This section describes how to migrate data from an existing Vibe server to a new Vibe server. You 
might want to do this for any of the following reasons: 

* Your existing Vibe system has outgrown the server where you originally set it up 

* You want to move your existing Vibe system to a different operating system 


In this case, you can install Vibe 3.4 on a new server, then migrate your existing Vibe 3.4 data (or 
data from a previous version of Vibe) to your new Vibe 3.4 system 


If you are migrating from a Teaming 2.1 server, follow the instructions in “Update” in the Novell 
Vibe OnPrem 3 Installation Guide (http:/Awww.novell.com/documentation/vibe_onprem3/ 
vibeprem3_inst/data/bookinfo.html). 


* You want to preserve your old system in its current state 


* You created your Vibe system by using the Virtual Eval version of the Novell Vibe Starter Pack 
(http://download.novell.com/Download?buildid=Y 7J2HFucjfw~) 


* You are upgrading from Kablink Vibe to Novell Vibe 
Complete the following sections to migrate your Vibe data: 


* Section 25.1, “Linux Migration with a MySQL Database,” on page 209 
* Section 25.2, “Windows Migration with an MS SQL Database,” on page 212 


NOTE: In these instructions, “target server” refers to the server where you install the Vibe 3.4 
software, and “source server” refers to the existing server from which you are migrating Vibe data. 


The instructions in this section are based on a single-server Vibe configuration. If you have a multi- 
server Vibe configuration, the single-server instructions can serve as a foundation to get you started 
with your more complex migration process. 


This section does not include instructions for migrating an Oracle database. Use the instructions for 
your Vibe platform as a guideline for the tasks that are involved in migrating Vibe data, then apply 
these guidelines to your Oracle database migration. 


25.1 Linux Migration with a MySQL Database 


* Section 25.1.1, “Preparing the Target Linux Server,” on page 210 

* Section 25.1.2, “Preparing the Source Linux Server,” on page 210 

* Section 25.1.3, “Transferring Data from the Source Server to the Target Server,” on page 210 
* Section 25.1.4, “Importing the Vibe Database to the Target Server,” on page 211 

* Section 25.1.5, “Updating the Vibe Database on the Target Server,” on page 211 

¢ Section 25.1.6, “Verifying the Default Zone Name,” on page 211 

* Section 25.1.7, “Finalizing Your New Vibe 3.4 Site,” on page 212 
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25.1.1 Preparing the Target Linux Server 


On the target server: 
1 Install the Vibe 3.4 software on the target server, as described in Part II, “Basic Installation,” on 
page 33, paying special attention to these important details: 


* Set up the same Linux user to run the Vibe software that has been used to run the Vibe 
software in the source Vibe server. 


* Select the same encryption algorithm for the Vibe database that was used for the source 
Vibe server. 


IMPORTANT: If the database encryption algorithms do not match between the source and 
target Vibe systems, you cannot log in to the new Vibe 3.4 site. 


2 Start Vibe on the target server. 
3 Verify that the new Vibe site is working as expected. 
4 Stop Vibe on the target server. 


5 Rename the teaming directory to teaming_backup. In a future step you will copy the teaming 
directory from the source server to the target server. 


The location of the teaming directory varies by platform: 


Linux: /var/opt/novell/teaming 


Windows: c:\novell\teaming 


6 Continue with Section 25.1.2, “Preparing the Source Linux Server,” on page 210. 


25.1.2 Preparing the Source Linux Server 


On the source server: 
1 Stop Vibe. 
2 Back up your existing database: 
mysqldump -uusername -ppassword sitescape > sitescape.sql 


This creates a file named sitescape.sql in the directory where you executed the mysqldump 
command. 


3 Ensure that you have a recent backup of your entire Vibe system. 


4 Continue with Section 25.1.3, “Transferring Data from the Source Server to the Target Server,” 
on page 210. 


25.1.3 Transferring Data from the Source Server to the Target 
Server 
On the source server: 


1 Mount the target server to the source server so that data can be copied from one server to the 
other. 


2 Ina terminal window on the source server, become the Linux user that runs the Vibe software. 
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3 Copy the database backup of your existing Vibe database (sitescape. sq1 file) that you created 
in Step 2 in Section 25.1.2, “Preparing the Source Linux Server,” on page 210 to a convenient 
temporary location on the target server. 


4 Copy the entire data area from /var/opt /novell/teaming on the source server to the same 
location on the target server. 


5 (Conditional) If you are using secure LDAP (LDAPS), you need to copy the cacerts file to the 
same location on the target server. 


6 Continue with Section 25.1.4, “Importing the Vibe Database to the Target Server,” on page 211. 


25.1.4 Importing the Vibe Database to the Target Server 


On the target server: 
1 Remove the empty Vibe database that was created when you installed the Vibe 3.4 software: 


mysql>drop database sitescape; 


2 Change to the directory where you copied the sitescape. sql file in Step 3 in Section 25.1.3, 
“Transferring Data from the Source Server to the Target Server,” on page 210. 


3 Create an empty database called sitescape: 


mysql -uusername -ppassword -e "create database sitescape" 


4 Manually re-create the Vibe database with the data that you copied from the source server: 


mysql -uusername -ppassword sitescape < sitescape.sql 


25.1.5 Updating the Vibe Database on the Target Server 


You must complete this section only if you are updating from Vibe 3.2 or earlier to Vibe 3.4. (Vibe 3.4 
does not contain any database changes, so there is no need to run the update script when updating 
from Vibe 3.3 to 3.4.) 


On the target server: 


1 Unzip the teaming-3.4.n.sql.zip file. 


2 Inthe teaming-3.4.n-sql folder, change to the resulting update-3.2.0-3.3.ndirectory, then 
run the update script to update the database from Vibe 3.2 to Vibe 3.3: 


mysql -uusername -ppassword < update-mysql.sql 


If you are updating from a version prior to 3.2, you need to run the appropriate update scripts in 
addition to the update script found in the update-3.2.0-3.3.n directory. 


For more complete database update instructions, refer to Section 21.3.2, “Manual Vibe 
Database Update,” on page 184. 


3 Continue with Section 25.1.7, “Finalizing Your New Vibe 3.4 Site,” on page 212. 


25.1.6 Verifying the Default Zone Name 
The default zone name of the target server must match the default zone name of the source server. 
To verify that the name of the target server is the same as the zone name of the source server: 


1 On the source server, navigate to the zone-ext .cfg.xml file and view the default zone name. 


The zone-ext .cfg.xml file is located in the following directory: 
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25.2.1 


2 
3 


4 


/opt/novell/teaming/apache-tomcat /webapps/ssf/WEB-INF/classes/config/ 
On the target server, navigate to the zone-ext .cfg.xml file, and view the default zone name. 


(Conditional) If the name on the target server is different than the name on the source server, 
change the name on the target server so that it matches the name of the source server. 


A Vibe site that originated as Teaming 1.0 has the default zone name of l1iferay.com. In this 


case, you need to change the default zone name on the target server to liferay.com. 


Save and close the zone-ext .cfg.xml file on the target server. 


Finalizing Your New Vibe 3.4 Site 


1 
2 


Start Vibe 3.4, as described in Section 4.1.7, “Starting Vibe on Linux,” on page 68. 


Reindex the Vibe site, as described in “Rebuilding the Lucene Index” in “Site Maintenance” in the 
Novell Vibe 3.4 Administration Guide. 


Your Vibe site should now function just as it did on the original source server. 


Windows Migration with an MS SQL Database 


Section 25.2.1, “Preparing the Target Windows Server,” on page 212 

Section 25.2.2, “Preparing the Source Windows Server,” on page 213 

Section 25.2.3, “Transferring Data from the Source Server to the Target Server,” on page 213 
Section 25.2.4, “Importing the Database to the Target Server,” on page 214 

Section 25.2.5, “Updating the Vibe Database on the Target Server,” on page 214 

Section 25.2.6, “Verifying the Default Zone Name,” on page 214 

Section 25.2.7, “Finalizing Your New Vibe 3.4 Site,” on page 215 


Preparing the Target Windows Server 


On the target server: 


1 
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Install the Vibe 3.4 software, as described in Part II, “Basic Installation,” on page 33. 


IMPORTANT: Select the same encryption algorithm for the Vibe 3.4 database that you selected 
for the source Vibe server. If the database encryption algorithms do not match between the 
source and target systems, you cannot log in to the new Vibe 3.4 site. 


Start Vibe on the target server. 
Verify that the new Vibe site is working as expected. 
Stop Vibe on the target server. 


Rename the teaming directory to teaming_backup. In a future step you will copy the teaming 
directory from the source server to the target server. 


The location of the teaming directory varies by platform: 


Linux: /var/opt/novell/teaming 


Windows: c:\Program Files\Novell\Teaming 


Continue with Section 25.2.2, “Preparing the Source Windows Server,” on page 213. 
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25.2.2 Preparing the Source Windows Server 


On the source server: 


1 Stop Vibe. 
2 Back up your existing database: 


2a In Microsoft SQL Server Management Studio, browse to and right-click the existing 
database (named sitescape), then click Tasks > Back Up. 


2b For Backup type, select Full. 
2c Set other backup options as desired, then click OK. 


This creates a file named sitescape.bak in the following directory: 
c:\Program Files\Microsoft SQL Server\MSSQL\Backup 


3 Make sure that you have a recent backup of your entire system. 


4 Continue with Section 25.2.3, “Transferring Data from the Source Server to the Target Server,” 
on page 213. 


25.2.3 Transferring Data from the Source Server to the Target 
Server 


On the source server: 
1 Map a drive from the target server to the source server so that data can be copied from one 
server to the other. 


2 Copy your existing software extensions to the target server: 


From: c:\home\icecoredata\extensions 


To: c:\novell\teaming\extensions 


Beginning with Vibe 3, the extensions directory now contains kablink and liferay.com 
directories. 


3 Delete the empty kablink directory. 
4 Delete or rename the following directories to make room for the corresponding directories that 
you are copying from the source server: 


c:\novell\teaming 
c:\novell\teaming\lucene 
c:\novell\teaming\extensions 


5 Copy the entire data area from c:\novell\teaming on the source server to the same location 
on the target server. 


6 (Conditional) If you are using secure LDAP (LDAPS), you need to copy the cacerts file to the 
same location on the target server. 


7 Continue with Section 25.2.4, “Importing the Database to the Target Server,” on page 214. 
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25.2.4 


25.2.5 


Importing the Database to the Target Server 


On the target server: 


1 


In Microsoft SQL Server Management Studio, browse to and right-click the existing Vibe 
database (named sitescape) that was created when you installed the Vibe 3.4 software, then 
click Delete. 


To import the data from your source database, browse to and right-click Databases, then click 
Tasks > Restore. 


3 Inthe To database field, specify sitescape. 


4 Inthe From device field, browse to and select the sitescape.bak file that you transferred to the 


target server. 
Set other restore options as desired, then click OK. 
This creates the sitescape database in the following directory on the target server: 


c:\Program Files\Microsoft SQL Server\MSSQL 


Backed-up data from the source database is imported into the database for your new Vibe 3.4 
system. 


Updating the Vibe Database on the Target Server 


You must complete this section only if you are updating from Vibe 3.2 or earlier to Vibe 3.4. (Vibe 3.4 
does not contain any database changes, so there is no need to run the update script when updating 
from Vibe 3.3 to 3.4.) 


On the target server: 


1 Unzip the teaming-3.3.n-sql.zip file, change to the resulting update-3.2.0-3.3.n directory, 


then run the update script to update the database from Vibe 3.2 to Vibe 3.3: 


osql -Uusername -Ppassword -i update-sqlserver.sql 


If you are updating from a version prior to 3.2, you need to run the appropriate update scripts in 
addition to the update script found in the update-3.2.0-3.3.n directory. 


For more complete database update instructions, refer to Section 21.3.2, “Manual Vibe 
Database Update,” on page 184. 


2 Continue with Section 25.2.7, “Finalizing Your New Vibe 3.4 Site,” on page 215. 


25.2.6 Verifying the Default Zone Name 


The default zone name of the target server must match the default zone name of the source server. 


To verify that the name of the target server is the same as the zone name of the source server: 


1 On the source server, navigate to the zone-ext .cfg.xml file and view the default zone name. 


The zone-ext .cfg.xml file is located in the following directory: 


C:\Program Files\Novell\Teaming\apache-tomcat\webapps\ssf\WEB- 
INF\classes\config 


2 On the target server, navigate to the zone-ext .cfg.xml file, and view the default zone name. 


3 (Conditional) If the name on the target server is different than the name on the source server, 


change the name on the target server so that it matches the name of the source server. 
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A Vibe site that originated as Teaming 1.0 has the default zone name of l1iferay.com. In this 
case, you need to change the default zone name on the target server to liferay.com. 


4 Save and close the zone-ext .cfg.xml file on the target server. 


25.2.7 Finalizing Your New Vibe 3.4 Site 


1 Start Vibe 3.4, as described in Section 4.1.7, “Starting Vibe on Linux,” on page 68. 


2 Reindex the Vibe site, as described in “Rebuilding the Lucene Index” in “Site Maintenance” in the 
Novell Vibe 3.4 Administration Guide. 


Your Vibe site should now function just as it did on the original source server. 
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Migrating from SiteScape Forum or 
Other Collaboration Software 


Moving legacy corporate data into a new collaboration system can look like a long, challenging 
process. To make the job easier, see the Novell Teaming Migration Services Flyer. (http:// 
www.novell.com/docrep/2009/04/Novell_ Teaming_Migration_Flyer_en.pdf) 


Migrating from SiteScape Forum or Other Collaboration Software 
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A.1 


A.1.1 


Vibe 3.4 HP2 System Requirements 
Assistance 


The system requirements for Novell Vibe include supporting components that might or might not 
already be installed on your Vibe server. This section helps you meet the Vibe system requirements if 
you are not familiar with how to install these supporting components. 

* Section A.1, “Java Development Kit (JDK),” on page 221 


* Section A.2, “Java Cryptography Extension (JCE),” on page 223 


Java Development Kit (JDK) 


The Novell Vibe software runs inside a Java Virtual Machine (JVM). At present, Vibe requires a Java 
Development Kit (JDK), not a Java Runtime Environment (JRE), in order to run properly. You can use 
either the Oracle JDK or the IBM JDK. Follow the instructions in the section below for your operating 
system and JDK preference: 


If you want to use an SSL connection between your Novell Vibe site and a WebDAV server, and if the 
WebDAV server has a self-signed certificate rather than a certificate provided by a certificate 
authority, you must use the Oracle JDK. The existing Vibe functionality for handling self-signed 
certificates is not compatible with the way the IBM JDK handles self-signed certificates. 

* Section A.1.1, “Oracle JDK on Linux,” on page 221 

* Section A.1.2, “IBM JDK on Linux,” on page 222 


* Section A.1.3, “Oracle JDK on Windows,” on page 222 


Oracle JDK on Linux 


This section describes how to install the Java Development Kit (JDK) for 64-bit Linux, using the 
following archive binary file: jdk-version-linux-x64.tar.gz. 
1 Goto the following URL: 
Java SE Downloads (http://www.oracle.com/technetwork/java/javase/downloads/index.html) 


2 Download the jdk-version-linux-x64.tar.gz file to the /usr/java directory on your Linux 
server. 


3 Accept the License Agreement. 


4 Asthe root user, change to the /usr/java directory where you downloaded the file, then use 
the following command to ensure that the download arrived safely: 


ls -1 
You should see a file named jdk-version-linux-x64.tar.gz. 
5 Extractthe file: 


tar -xvf jdk-version-linux-x64.tar.gz 


The Oracle JDK is now installed on your Linux server. 
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6 (Conditional) You might need to remove a symbolic link and create a new one: 
rm /usr/java/latest 
ln -s /usr/java/jdkversion /usr/java/latest 
7 Run the following two commands: 
chmod -R 755 /usr/java/jdkversion 
chown -R root:root /usr/java/jdkversion 


8 Install the JCE, as described in Section A.2, “Java Cryptography Extension (JCE),” on page 223. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
plan to install the JDK. The Vibe installation program prompts you for this location. 


A.1.2 IBM JDK on Linux 


The IBM JDK is available with SUSE Linux Enterprise Server (SLES). You can install it by using 
YaST. 
1 Enable the SDK online repositories. 


For information about how to enable the SDK repositories on SLES, see TID 7015337 (https:// 
www.novell.com/support/kb/doc.php?id=7015337) in the Novell Support Knowledgebase (https:/ 
/www.novell.com/support/kb/). 


In YaST, click Software > Software Management. 
In the Search field, type java, then click Search. 


Select Java version SDK, Standard Edition (java-version-ibm-deve1), then click Accept. 


ao Aà OO N 


Click Continue to accept the suggested dependencies, then click No (because you don’t need 
any more packages). 


6 Exit YaST. 


This creates a directory named /usr/lib/jvm/java-version-ibm-version sr3 with the IBM 
JDK software in it. 


7 Install the JCE, as described in Section A.2, “Java Cryptography Extension (JCE),” on page 223. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
plan to install the JDK. The Vibe installation program prompts you for this location. 


A.1.3 Oracle JDK on Windows 


1 Go to the following URL: 

Java SE Downloads (http://www.oracle.com/technetwork/java/javase/downloads/index.html) 
2 Download the latest Java SE version that is appropriate for your operating system. 
3 Accept the license agreement. 


4 Click the jak-version-windows-version.exe file in the Download column, then save the file to 
an empty temporary directory on your Windows server. 


5 Change to that temporary directory, then run the downloaded executable. 
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A.2 


A.2.1 


A.2.2 


This creates a directory named c:\Program Files\Java\jdkversion with the Oracle JDK 
software in it. 


The Oracle JDK is now installed on your Windows server. 
Install the JCE, as described in Section A.2, “Java Cryptography Extension (JCE),” on page 223. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
plan to install the JDK. The Vibe installation program prompts you for this location. 


Java Cryptography Extension (JCE) 


You must install the Java Cryptography Extension (JCE) in addition to the JDK. 


Oracle JCE on Linux and Windows 


1 


2 


On your management workstation, download the Java Cryptography Extension (JCE) Unlimited 
Strength Jurisdiction Policy files (http://www.oracle.com/technetwork/java/javase/downloads/ 
jce8-download-2133166.html) from Oracle. 


Follow the instructions from the Readme that is downloaded with the Oracle JCE. 


IBM JCE on Linux 


To install the JCE on Linux: 


1 


On the Vibe server, verify that the following files exist: 


/etc/alternatives/jce_version ibm local policy 
/etc/alternatives/jce_version ibm us export policy 


On your management workstation, download the Java Cryptography Extension (JCE) Unlimited 
Strength Jurisdiction Policy files (https://mww14.software.ibm.com/webapp/iwm/web/reg/ 
pick.do?source=jcesdk&lang=en_US) from IBM. 


Log in to the Vibe server as the root user (or equivalent), then create the following directory: 
mkdir -p /usr/lib64/jvm-private/java-version-ibm/jce/unrestricted 


Copy the JCE Unlimited Strength Jurisdiction Policy ZIP file to the folder on the Vibe server that 
you created in Step 3. 


cp -/Downloads/unrestrictedpolicyfiles.zip /usr/lib64/jvm-private/java- 
version-ibm/jce/urestricted 


Unzip the files: 


unzip /usr/lib64/jvm-private/java-version-ibm/jce/unrestricted/ 
urestrictedpolicyfiles.zip 


Stop Vibe. 

/etc/init.d/teaming stop 

Remove the existing links: 

rm /etc/alternatives/jce version ibm local policy 


rm /etc/alternatives/jce_ version ibm us export policy 


Create a new link to the JCE that you downloaded: 
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ln -s /usr/lib64/jvm-private/java-version-ibm/jce/unrestricted/ 
local _policy.jar /etc/alternatives/jce_version ibm local policy 


ln -s /usr/lib64/jvm-private/java-version-ibm/jce/unrestricted/ 
US export _policy.jar /etc/alternatives/jce_version ibm us export policy 


9 Verify that the links were created: 
ls -1 /etc/alternatives/jce* 
10 Start Vibe. 
/etc/init.d/teaming start 
tailf /opt/novell/teaming/apache-tomcat/logs/catalina.out 


tailf /opt/novell/teaming/apache-tomcat/logs/appserver.log 
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B.1 


B.1.1 


Vibe 3.4 System Requirements 
Assistance 


The system requirements for Novell Vibe include supporting components that might or might not be 
already installed on your Vibe server. This section helps you meet the Vibe system requirements if 
you are not familiar with how to install these supporting components. 

* Section B.1, “Java Development Kit,” on page 225 


* Section B.2, “MySQL Database Server,” on page 228 


Java Development Kit 


The Novell Vibe software runs inside a Java Virtual Machine (JVM). At present, Vibe requires a Java 
Development Kit (JDK), not a Java Runtime Environment (JRE), in order to run properly. You can use 
either the Oracle JDK or the IBM JDK. Follow the instructions in the section below for your operating 
system and JDK preference: 


If you want to use an SSL connection between your Novell Vibe site and a WebDAV server, and if the 
WebDAV server has a self-signed certificate rather than a certificate provided by a certificate 
authority, you must use the Oracle JDK. The existing Vibe functionality for handling self-signed 
certificates is not compatible with the way the IBM JDK handles self-signed certificates. 


Oracle JDK 6.0 is supported on both Windows and Linux; Oracle JDK 7.0 is supported only on 
Windows. IBM JDK 6.0 and 7.0 are supported only on Linux. 

* Section B.1.1, “Oracle JDK on Linux,” on page 225 

¢ Section B.1.2, “IBM JDK on Linux,” on page 226 

* Section B.1.3, “Oracle JDK on Windows,” on page 227 


Oracle JDK on Linux 


1 Go to the following URL: 
Java SE Downloads (http://www.oracle.com/technetwork/java/javase/downloads/index.html) 
The update you need is listed as “Java SE 6 Update nn.” 

2 Click Download next to this update. 

3 Accept the License Agreement. 


4 Click the jdk-6unn-linux-version-rpm.bin file in the Download column, then save the file to 
an empty temporary directory on your Linux server. 


5 As the root user, change to that temporary directory, then use the following command to make 
sure that the download arrived safely: 


ls -1 
You should see a file named jdk-6unn-linux-version-rpm.bin. 


6 Change the permissions on the file to include execute permissions: 
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chmod +x jdk-6unn-linux-version-rpm.bin 
Run the self-extracting file: 
./jdk-6unn-linux-version-rpm.bin 


This creates a file named jdk-6unn-linux-version.rpm, and a directory named /usr/java/ 
jdk.1.6.0_nn with the Oracle JDK software in it. 


The Oracle JDK is now installed on your Linux server. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
install the JDK. The Vibe installation program prompts you for this location. 


IBM JDK on Linux 


+ 


+ 


“Installing the IBM JDK on SUSE Linux Enterprise Server 11” on page 226 


“Installing the IBM JDK on Open Enterprise Server 2 and SUSE Linux Enterprise Server 10” on 
page 227 


Installing the IBM JDK on SUSE Linux Enterprise Server 11 


The IBM JDK 6.0 is available with SUSE Linux Enterprise Server (SLES) 11, which is used for Open 
Enterprise Server (OES) 2. You can install it by using YaST. 


1 
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Enable the SDK online repositories. 


For information about how to enable the SDK repositories on SLES 11, see TID 7015337 (https:/ 
/www.novell.com/support/kb/doc.php?id=7015337) in the Novell Support Knowledgebase 
(https:/Awww.novell.com/support/kb/). 


In YaST, click Software > Software Management. 
In the Search field, type ibm, then click Search. 
Select Java 6 SDK, Standard Edition (java-1_6_0-ibm-deve1), then click Accept. 


Click Continue to accept the suggested dependencies, then click No because you don’t need 
any more packages. 


Exit YaST. 
This creates a directory named /usr/lib/jvm/java-1_6_0-ibm-1.6.0_sr3 with the IBM JDK 


software in it. 
BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
install the JDK. The Vibe installation program prompts you for this location. 
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Installing the IBM JDK on Open Enterprise Server 2 and SUSE Linux 
Enterprise Server 10 


The IBM JDK 6.0 is not included with SUSE Linux Enterprise Server (SLES) 10. 
To download the IBM JDK 6.0: 


1 Go to the following URL: 
Java SE Downloads (http://www.ibm.com/developerworks/java/jdk/linux/download.html) 


2 In the Java SE Version 6 table, in the Download column, click the appropriate link for your 
operating system. 


3 Sign in using your IBM account. If you don’t have an account, create one. 
4 Agree to IBM’s License Agreement, then continue. 


5 Download the ibm-java-1386-sdk-6.0-n.n.i386.rpm file to an empty temporary directory on 
your Linux server. 


6 Change to that directory, then run the downloaded file. 
This creates a directory named opt \ibm with the IBM JDK in it. 


The IBM JDK is now installed on your Linux server. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
install the JDK. The Vibe installation program prompts you for this location. 


B.1.3 Oracle JDK on Windows 


1 Goto the following URL: 
Java SE Downloads (http://www.oracle.com/technetwork/java/javase/downloads/index.html) 
The update you need is listed as “Java SE 6 Update nn.” 

2 Click Download next to this update. 

3 Accept the license agreement. 


4 Click the jak-6unn-windows-version.exe file in the Download column, then save the file to an 
empty temporary directory on your Windows server. 


5 Change to that temporary directory, then run the downloaded executable. 


This creates a directory named c:\Program Files\Java\jdk6éunn with the Oracle JDK 
software in it. 


The Oracle JDK is now installed on your Windows server. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Java JDK Location on the Basic Vibe Installation Summary Sheet, specify the directory where you 
install the JDK. The Vibe installation program prompts you for this location. 
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B.2 


B.2.1 


MySQL Database Server 


* Section B.2.1, “MySQL on Linux,” on page 228 
* Section B.2.2, “MySQL on Windows,” on page 229 


MySQL on Linux 


Depending on the options you select when installing Open Enterprise Server 2 and SUSE Linux 
Enterprise Server (SLES), the MySQL database server might be installed along with the operating 
system. Check for the following directory: 
/usr/bin/mysql 
If the /usr/bin/mysq1l directory does not exist, you need to install the MySQL database server. If 
MySQL is already installed, you still need to configure it for use with Vibe. 

¢ “Installing MySQL” on page 228 

+ “Configuring MySQL” on page 228 

* “Learning More about MySQL” on page 229 


Installing MySQL 


Make sure you have access to your operating system installation media. 
In YaST, click Software > Software Management. 

In the Search field, type mysql, then click Search. 

Select mysql, then click Accept. 

Click Continue to resolve dependencies. 
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Click Continue to acknowledge package support status. 
MySQL is then installed from the SLES media. 
7 Continue with “Configuring MySQL” on page 228. 


Configuring MySQL 


When MySQL is initially installed, it is not configured with an administrator password, nor is it 
configured to start automatically. Follow the steps below to set up the MySQL database server for use 
with Vibe: 

In YaST, click System > System Services. 

Scroll to and select the MySQL service, then click Enable. 

Click Continue to install dependencies, then click OK to close the status box. 

Click OK > Yes to finish the installation, then exit YaST. 


In a terminal window, become the root user. 
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To verify that the MySQL database server has started, use the following command: 
ps -eaf | grep mysql 

You should see MySQL processes running. 

7 Set the administrator password for the MySQL database server: 
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mysqladmin -u root password new password 


This command changes the password for the MySQL root user, which is the default 
administrator username for the MySQL database server. This command is part of the MySQL 
client package. 


IMPORTANT: The MySQL root username is not the same as the Linux root user. The Linux 
root user has a password established for it when you install Linux. In a parallel fashion, the 
MySQL root user needs to have a password established for it when you install MySQL. 


BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Credentials on the Basic Vibe Installation Summary Sheet, specify the MySQL 
administrator password. The Vibe installation program prompts you for this information. 


Learning More about MySQL 


The following table includes some basic and useful MySQL commands: 


Action Command 
Stop MySQL /etc/initd/mysql stop 
Start MySQL /etc/initd/mysql start 


Show MySQL status mysqladmin -u root -p extended-status 


If you want to administer MySQL through a GUI interface, you can download tools from: 
MySQL GUI Tools Downloads (http://dev.mysql.com/downloads/gui-tools/5.0.html) 
For more information about MySQL, see: 


MySQL Documentation (http://dev.mysql.com/doc) 


B.2.2 MySQL on Windows 


1 In your Web browser, go to the following URL: 
MySQL 5.1 Downloads (http://dev.mysgl.com/downloads/mysql/5.1.html) 


2 Scroll down if necessary, then click the type of Windows operating system you are using (32-bit 
or 64-bit). 


On the Windows Essentials line, click Download. 

Click Save File, browse to and select a convenient temporary directory, then click Save. 
In Windows Explorer, browse to the directory where you saved the MySQL .exe file. 
Double-click the MySQL . exe file to start the MySQL Setup Wizard. 


Follow the online instructions to install the MySQL software on the Windows server, then 
continue with Step 8 to configure the server. 
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8 Unless you are already familiar with configuring MySQL on a Windows server, select Standard 
Configuration, then click Next. 


9 Select Include Bin Directory in Windows PATH, then click Next. 
10 Set the MySQL root user password, then click Next. 
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BASIC VIBE INSTALLATION SUMMARY SHEET 


Under Database Credentials on the Basic Vibe Installation Summary Sheet, specify the MySQL 
administrator password. The Vibe installation program prompts you for this information. 


11 Click Execute to configure the MySQL database server, then click Finish. 
Some messages report the status of your MySQL installation. 


12 To monitor the MySQL database server, click Start > All Programs, then click MySQL > MySQL 
Server 5.1 > MySQL Command Line Client. 
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Memcached Caching with Novell 
Vibe 


Novell Vibe contains two caching options for the hibernate caching provider: ehcache and 
memcached. For more information about ehcache, see Ehcache (http://ehcache.sourceforge.net). 
* Section C.1, “About Memcached,” on page 231 
* Section C.2, “Downloading and Installing Memcached,” on page 231 
* Section C.3, “Configuring Memcached,” on page 232 
* Section C.4, “Configuring Memcached in the Vibe Installation Program,” on page 233 


¢ Section C.5, “Memcached Logging,” on page 233 


C.1 About Memcached 


Memcached is a high-performance, distributed memory object caching system used by a number of 
large Internet sites such as Wikipedia, Flickr, Twitter, Youtube, and Craigslit, as well as enterprise 
systems. 


* Section C.1.1, “Advantages for Using Memcached,” on page 231 
* Section C.1.2, “Hardware Requirements and Configurations,” on page 231 


C.1.1 Advantages for Using Memcached 


Memcached offers the following advantages over other caching systems: 


* Better utilization of memory resources from the server farm. 


* No replication (and therefore no overhead involved in replication). This results in a reduction of 
60 or more threads per Vibe node in a two-node cluster. 


+ The number of servers and the size of data scale together. 
* Scales out much better than replication-based cluster cache. 


C.1.2 Hardware Requirements and Configurations 


Novell Vibe supports memcached only on the SUSE Linux operating system. For detailed hardware 
requirements and layouts, see Memcached Hardware Requirements and Layouts (http:// 
code.google.com/p/memcached/wiki/NewHardware). 


C.2 Downloading and Installing Memcached 


NOTE: You should run memcached only on a SUSE Linux operating system. 64-bit is recommended. 


Memcached is included with the SUSE Linux Enterprise High Availability Extension. You simply need 
to install it on each Vibe Tomcat node as you would any other Linux package. 
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If you do not have the SUSE Linux Enterprise High Availability Extension, you can download and 
install memcached by completing the following steps on each node in the Vibe cluster. 

Navigate to the openSUSE Software Download page (http://software.opensuse.org). 

In the Search field, type memcached, then click Search. 

Download the rpm file after it is returned in the search results. 


1 

2 

3 

4 Install the downloaded Ren file. 

5 Repeat Step 1 through Step 4 on each Vibe node in the cluster. 
6 


Continue with Section C.3, “Configuring Memcached,” on page 232. 


C.3 Configuring Memcached 


After you have downloaded and installed memcached on each Vibe Tomcat node in the cluster, as 
described in Section C.2, “Downloading and Installing Memcached,” on page 231, you need to 
configure it on each node. 


You configure memcached by adding the desired switches to the MEMCACHED PARAMS variable. 


1 Navigate to the etc/sysconfig directory. 
2 Open the memcached file in a text editor. 


3 Uncomment the MEMCACHED PARAMS variable and add any switches that you feel are appropriate. 
When you uncomment the MEMCACHED PARAMS variable, the following switches are already 
present: 


+ -d: Runs as a daemon. This is recommended. 


+ -I: Determines the interface to listen on. The default value is the localhost. You should either 
delete this switch with its default address (this is recommended for a simple setup), or 
change the default address to the address that you want memcached to listen on. For 
example, -1 172.17.2.3. 


To see a complete list of switches that are available with memcached, type memcached -h from 
the command line of a machine where memcached is installed. 


4 (Recommended) Increase the maximum memory to use for items to 1024 MB. You do this by 
adding the -m switch to the MEMCACHED PARAMS variable. For example: 


-m 1024 


5 (Recommended) You should configure memcached to start automatically each time you reboot 
the Linux server where Vibe is running. To configure memcached to start automatically, enter the 
following command from the command line: 


chkconfig --add memcached 


To verify that automatic startup is enabled, enter the following command from the command line: 


chkconfig memcached 


6 Validate that memcached is running from the local server by typing the following command: 


netstat -ap|grep memcached 


7 After you have verified that memcached is running on the local server, log in to a remote server, 
then validate that memcached is running to ensure that no networking problems exist: 


7a From the command line of a remote server, make a network connection to the server where 
memcached is running. For example, you can use the telnet command. 
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C.4 


C.5 


telnet 172.17.2.3 11211 


7b Type a simple memcached command, such as stats and stats settings. 
7c After you have verified that memcached is running as expected, type quit to exit telnet. 


Following is an example of what you see: 


07309:-/Desktop # telnet xxx.xxx.xxx.xx 11211 
Trying XXX.XXX.XXX.XX... 
Connected to xxx.XXx.XXX.XX. 
Escape character is '*]'. 
stats 

STAT pid 2486 

STAT uptime 313 

STAT time 1334337169 

STAT version 1.2.6 

STAT pointer size 64 

STAT rusage user 0.028001 
STAT rusage system 0.000000 
STAT curr items 10 

STAT total items 17 

STAT bytes 7971 

STAT curr connections 4 

STAT total connections 6 
STAT connection structures 5 
STAT cmd get 79 

STAT cmd set 17 

STAT get hits 62 

STAT get misses 17 

STAT evictions 0 

STAT bytes read 14249 

STAT bytes written 67674 
STAT limit maxbytes 67108864 
STAT threads 1 

END 

quit 

Connection closed by foreign host. 
07309:-/Desktop # 


8 Repeat Step 1 through Step 7 for each Vibe node in the cluster. 


9 Continue with Section C.4, “Configuring Memcached in the Vibe Installation Program,” on 
page 233. 


Configuring Memcached in the Vibe Installation 
Program 


After you have installed and configured memcached, you need to configure the Vibe installation 
program to use memcached as the hibernate caching provider. For more information, see 
Section 4.1.2, “Running the Linux Vibe Installation Program,” on page 63. 


Memcached Logging 


To trace activities on the Vibe server that are related to memcached: 


1 Navigate to the following /opt/novell/teaming/apache-tomcat/webapps/ssf/WEB-INF 
directory. 
2 Open the 10g4j .properties file in a text editor. 


3 Uncomment the following lines in the log4j.properties file: 
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# Tracing of memcached 


#log4j .category.net 


. Spy .memcached=DEBUG 
#log4j.category.net. 
#log4j.category.com. 
#log4j.category.com. 
#log4j.category.com. 


rubyeye .xmemcached=DEBUG 
googlecode.hibernate.memcached=DEBUG 
novell .teaming.memcached=DEBUG 
novell.teaming.hibernate.memcached=DEBUG 


4 Save and close the 1094; .properties file. 


5 Restart the Vibe server. 
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* Section D.1, “ANTLR 3 License,” on page 235 

* Section D.2, “Colt License Agreement,” on page 236 

¢ Section D.3, “Dom4j License,” on page 236 

* Section D.4, “iCal4j License,” on page 237 

* Section D.5, “ICU4J license (ICU4J 1.3.1 and later),” on page 237 
* Section D.6, “JAXEN License,” on page 238 

* Section D.7, “Jung,” on page 238 

* Section D.8, “ASM,” on page 239 

* Section D.9, “Firebug Lite,” on page 240 


ANTLR 3 License 


Copyright (c) 2003-2008, Terence Parr 
All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met 


* Redistributions of source code must retain the above copyright notice, this list of conditions and 
the following disclaimer. 


¢ Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


* Neither the name of the author nor the names of its contributors may be used to endorse or 
promote products derived from this software without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE. 
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Colt License Agreement 


Packages cern.colt*, cern.jet*, cern.clhep 
Copyright (c) 1999 CERN - European Organization for Nuclear Research. 


Permission to use, copy, modify, distribute and sell this software and its documentation for any 
purpose is hereby granted without fee, provided that the above copyright notice appear in all 
copies and that both that copyright notice and this permission notice appear in supporting 
documentation. CERN makes no representations about the suitability of this software for any 
purpose. It is provided “as is” without expressed or implied warranty. 


Packages hep.aida.* 


Written by Pavel Binko, Dino Ferrero Merlino, Wolfgang Hoschek, Tony Johnson, Andreas 
Pfeiffer, and others. Check the FreeHEP home page for more info. Permission to use and/or 
redistribute this work is granted under the terms of the LGPL License, with the exception that any 
usage related to military applications is expressly forbidden. The software and documentation 
made available under the terms of this license are provided with no warranty. 


Dom4j License 


Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved. 


Redistribution and use of this software and associated documentation (“Software”), with or without 
modification, are permitted provided that the following conditions are met: 


1. 1.Redistributions of source code must retain copyright statements and notices. Redistributions 
must also contain a copy of this document. 


2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


3. The name “DOM4J” must not be used to endorse or promote products derived from this 
Software without prior written permission of MetaStuff, Ltd. For written permission, please 
contact dom4j-info@metastuff.com. 


4. The name “DOM4J” must not be used to endorse or promote products derived from this 
Software without prior written permission of MetaStuff, Ltd. For written permission, please 
contact dom4j-info@metastuff.com. 


5. Products derived from this Software may not be called “DOM4J” nor may “DOM4J” appear in 
their names without prior written permission of MetaStuff, Ltd. DOM4J is a registered trademark 
of MetaStuff, Ltd. 


6. Due credit should be given to the DOM4J Project (http://www.dom4j.org). 


THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS “AS IS” AND ANY 
EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS CONTRIBUTORS BE LIABLE FOR 
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 


Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved. 
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ICal4j License 


Copyright (c) 2008, Ben Fortuna 
All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met: 


¢ Redistributions of source code must retain the above copyright notice, this list of conditions and 
the following disclaimer. 


¢ Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


+ Neither the name of Ben Fortuna nor the names of any other contributors may be used to 
endorse or promote products derived from this software without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE. 


ICU4J license (ICU4J 1.3.1 and later) 


COPYRIGHT AND PERMISSION NOTICE 
Copyright (c) 1995-2001 International Business Machines Corporation and others 
All rights reserved. 


Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
associated documentation files (the "Software"), to deal in the Software without restriction, including 
without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the 
Software, and to permit persons to whom the Software is furnished to do so, provided that the above 
copyright notice(s) and this permission notice appear in all copies of the Software and that both the 
above copyright notice(s) and this permission notice appear in supporting documentation. 


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS, 
IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE 
LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR 
ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
SOFTWARE. 
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Except as contained in this notice, the name of a copyright holder shall not be used in advertising or 
otherwise to promote the sale, use or other dealings in this Software without prior written 
authorization of the copyright holder. 


JAXEN License 


Copyright (C) 2000-2002 Bob McWhirter & James Strachan. 
All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met: 


1. Redistributions of source code must retain the above copyright notice, this list of conditions, and 
the following disclaimer. 


2. Redistributions in binary form must reproduce the above copyright notice, this list of 
conditions, and the disclaimer that follows these conditions in the documentation and/or other 
materials provided with the distribution. 


3. The name “Jaxen” must not be used to endorse or promote products derived from this 
software without prior written permission. For written permission, please contact 
license @jaxen.org. 


4. Products derived from this software may not be called “Jaxen,” nor may “Jaxen” appear in their 
name, without prior written permission from the Jaxen Project Management (pm@jaxen.org). 


In addition, we request (but do not require) that you include in the end-user documentation provided 
with the redistribution and/or in the software itself an acknowledgement equivalent to the following: 


“This product includes software developed by the Jaxen Project (http://www.jaxen.org).” 


Alternatively, the acknowledgment may be graphical using the logos available at http:// 
www.jaxen.org. 


THIS SOFTWARE IS PROVIDED “AS IS” AND ANY EXPRESSED OR IMPLIED WARRANTIES, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE Jaxen 
AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 


This software consists of voluntary contributions made by many individuals on behalf of the Jaxen 
Project and was originally created by bob mcwhirter (bob@werken.com) and James Strachan 
(jstrachan@apache.org). For more information on the Jaxen Project, please see http:// 
www.jaxen.org. 


Jung 


THE JUNG LICENSE 
Copyright (c) 2003-2004, Regents of the University of California and the JUNG Project 
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All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met: 


¢ Redistributions of source code must retain the above copyright notice, this list of conditions and 
the following disclaimer. 


¢ Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


+ Neither the name of the University of California nor the names of its contributors may be used to 
endorse or promote products derived from this software without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 
EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 


ASM 


Copyright (c) 2000-2005, INRIA, France Telecom 
All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met: 


¢ Redistributions of source code must retain the above copyright notice, this list of conditions and 
the following disclaimer. 


¢ Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


* Neither the name of the copyright holders nor the names of its contributors may be used to 
endorse or promote products derived from this software without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 
EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
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Firebug Lite 


Copyright (c) 2006-2007, Joe Hewitt 
All rights reserved. 


Redistribution and use in source and binary forms, with or without modification, are permitted 
provided that the following conditions are met: 


¢ Redistributions of source code must retain the above copyright notice, this list of conditions and 
the following disclaimer. 


¢ Redistributions in binary form must reproduce the above copyright notice, this list of conditions 
and the following disclaimer in the documentation and/or other materials provided with the 
distribution. 


* Neither the name of the copyright holders nor the names of its contributors may be used to 
endorse or promote products derived from this software without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 
EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
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Documentation Updates 


Changes made to this guide since the initial release of Vibe 3.4 are listed below. 


Section Changed Summary of Changes 
* Section 2.1, “Vibe 3.4 HP2 Server Sections added for the Vibe 3.4 Hot Patch 2 release. 
Requirements,” on page 19 


* Chapter 19, “Updating from Vibe 3.4 to Vibe 3.4 
HP2,” on page 173 


* Appendix A, “Vibe 3.4 HP2 System 
Requirements Assistance,” on page 221 
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